функция MPI_Cart_sub

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

Синтаксис

int MPIAPI MPI_Cart_sub(
        MPI_Comm comm,
  _In_  int      *remain_dims,
  _Out_ MPI_Comm *newcomm
);

Параметры

• Comm
  Коммуникатор с декартовой структурой.

• remain_dims [in]
  I-ая запись remain_dims указывает, хранится ли i-е измерение в подсети (true) или удаляется (false).

• newcomm [out]
  Communicator, содержащий вложенную сетку, включающую вызывающий процесс.

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

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

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

Fortran

    MPI_CART_SUB(COMM, REMAIN_DIMS, NEWCOMM, IERROR)
        INTEGER COMM, NEWCOMM, IERROR
        LOGICAL REMAIN_DIMS(*)

Требования

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