Delen via


MPI_Cart_create functie

Hiermee maakt u een nieuwe communicator waaraan topologiegegevens zijn gekoppeld.

Syntaxis

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

Parameters

  • comm_old
    Invoercommunicator.

  • ndims
    Aantal dimensies van cartesisch raster.

  • Dims
    Matrix met gehele getallen van grootteweergaven die het aantal processen in elke dimensie aangeeft.

  • Perioden
    Logische matrix van grootteweergaven die aangeven of het raster periodiek (waar) of niet (onwaar) is in elke dimensie.

  • Opnieuw ordenen
    Rangschikking kan worden aangepast (true) of niet (false).

  • comm_cart [uit]
    Communicator met nieuwe cartesische topologie.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter 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

Vereisten

Product

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

Header

Mpi.h; Mpif.h

Bibliotheek

Msmpi.lib

DLL

Msmpi.dll

Zie ook

MPI-procestopologiefuncties