Compartilhar via


função MPI_Cart_sub

Particiona um comunicador em subgrupos que formam subgrids cartesianos de menor dimensão.

Sintaxe

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

Parâmetros

  • comm
    Comunicador com estrutura cartesiana.

  • remain_dims [in]
    A entrada i-th de remain_dims especifica se a dimensão i-th é mantida na subgrid (true) ou é descartada (false).

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

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

No Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

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

Requisitos

Produto

Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008

parâmetro

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Confira também

Funções de topologia de processo MPI