MPI_Cart_create-Funktion

Erstellt einen neuen Kommunikator, dem Topologieinformationen angefügt wurden.

Syntax

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

Parameter

• comm_old
  Eingabekommunikator.

• ndims
  Anzahl der Dimensionen des kartesischen Rasters.

• Dims
  Ganzzahliges Array der Größe ndims , das die Anzahl der Prozesse in jeder Dimension angibt.

• Zeiten
  Logisches Array von Größen-ndims, das angibt, ob das Raster in jeder Dimension periodisch (true) oder nicht (false) ist.

• Neu anordnen
  Die Rangfolge kann neu sortiert werden (true) oder nicht (false).

• comm_cart [out]
  Communicator mit neuer kartesischer Topologie.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

    MPI_CART_CREATE(COMM_OLD, NDIMS, DIMS, PERIODS, REORDER, COMM_CART, IERROR)
        INTEGER COMM_OLD, NDIMS, DIMS(*), COMM_CART, IERROR
        LOGICAL PERIODS(*), REORDER

Anforderungen

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI-Prozesstopologiefunktionen