Compartilhar via


Função MPI_Cart_create

Cria um novo comunicador ao qual as informações de topologia foram anexadas.

Sintaxe

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
);

Parâmetros

  • comm_old
    Comunicador de entrada.

  • ndims
    Número de dimensões da grade cartesiana.

  • Escurece
    Matriz de inteiros de ndims de tamanho especificando o número de processos em cada dimensão.

  • Períodos
    Matriz lógica de ndims de tamanho especificando se a grade é periódica (true) ou não (false) em cada dimensão.

  • Reordenar
    A classificação pode ser reordenada (true) ou não (false).

  • comm_cart [out]
    Comunicador com nova topologia cartesiana.

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_CREATE(COMM_OLD, NDIMS, DIMS, PERIODS, REORDER, COMM_CART, IERROR)
        INTEGER COMM_OLD, NDIMS, DIMS(*), COMM_CART, IERROR
        LOGICAL PERIODS(*), REORDER

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