Partilhar via


função MPI_Cart_create

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

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 grelha cartesiana.

  • dims
    Matriz de números inteiros de ndims de tamanho que especifica o número de processos em cada dimensão.

  • períodos
    Matriz lógica de ndims de tamanho que especifica se a grelha é periódica (verdadeira) ou não (falso) em cada dimensão.

  • reordenar
    A classificação pode ser reordenada (verdadeiro) ou não (falso).

  • comm_cart [fora]
    Communicator com nova topologia cartesiana.

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

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