функция MPI_Cart_create

Создает новый коммуникатор, к которому были присоединены сведения о топологии.

Синтаксис

int MPIAPI MPI_Cart_create(
        MPI_Comm              comm_old,
        int                   ndims,
        _In_count_(ndims) int *dims,
        _In_count_(ndims) int *periods,
        int                   reorder,
  _Out_ MPI_Comm              *comm_cart
);

Параметры

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

• ndims
  Количество измерений декартовой сетки.

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

• Периоды
  Логический массив ndim размера, указывающий, является ли сетка периодической (true) или нет (false) в каждом измерении.

• Переупорядочить
  Ранжирование может быть переупорядочено (true) или не (false).

• comm_cart [out]
  Communicator с новой декартовой топологией.

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

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

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

Fortran

    MPI_CART_CREATE(COMM_OLD, NDIMS, DIMS, PERIODS, REORDER, COMM_CART, IERROR)
        INTEGER COMM_OLD, NDIMS, DIMS(*), COMM_CART, IERROR
        LOGICAL PERIODS(*), REORDER

Требования

Продукт	Распространяемый пакет 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