функция MPI_Cart_map

Сопоставляет процесс со сведениями о декартовой топологии.

Синтаксис

int MPIAPI MPI_Cart_map(
        _In_              MPI_Comm comm,
        _In_range_(>=, 0) int      ndims,
        _In_count_(ndims) int      *dims,
        _In_count_(ndims) int      *periods,
        _Out_             int      *newrank
);

Параметры

• Comm
  Входной коммуникатор.

• ndims
  Число измерений декартовой структуры.

• Dims
  Целочисленный массив ndims размера, указывающий количество процессов в каждом направлении координат.

• Периоды
  Логический массив ndims размера, указывающий спецификацию периодичности в каждом направлении координат.

• newrank [out]
  переупорядоченный ранг вызывающего процесса; MPI_UNDEFINED , если вызывающий процесс не принадлежит сетке

Возвращаемое значение

Возвращает MPI_SUCCESS при успешном выполнении. В противном случае возвращаемое значение представляет собой код ошибки.

В Fortran возвращаемое значение хранится в параметре IERROR .

Fortran

    MPI_CART_MAP(COMM, NDIMS, DIMS, PERIODS, NEWRANK, IERROR)
        INTEGER COMM, NDIMS, DIMS(*), NEWRANK, IERROR
        LOGICAL PERIODS(*)

Требования

Продукт	Распространяемый пакет HPC 2012 MS-MPI, пакет HPC 2008 R2 распространяемый пакет MS-MPI, пакет HPC 2008 MS-MPI или клиентские служебные программы пакета HPC 2008
Заголовок	Mpi.h; Mpif.h
Библиотека	Msmpi.lib
DLL	Msmpi.dll

См. также раздел

Функции топологии процесса MPI