Partilhar via


função MPI_Cart_sub

Cria partições de um comunicador em subgrupos que formam subgrelhas cartesianas de dimensão inferior.

Sintaxe

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

Parâmetros

  • vírgula
    Communicator com estrutura cartesiana.

  • remain_dims [em]
    A i-th entrada de remain_dims especifica se a dimensão i-th é mantida na subgrelha (verdadeiro) ou se é removida (falsa).

  • newcomm [out]
    Communicator que contém a subgrelha que inclui o processo de chamada.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .

Fortran

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

Requisitos

Produto

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

Funções de Topologia de Processo de MPI