MPI_Cart_map-Funktion

Ordnet den Prozess kartesianischen Topologieinformationen zu.

Syntax

int MPIAPI MPI_Cart_map(
        _In_              MPI_Comm comm,
        _In_range_(>=, 0) int      ndims,
        _In_count_(ndims) int      *dims,
        _In_count_(ndims) int      *periods,
        _Out_             int      *newrank
);

Parameter

• comm
  Eingabekommunikator.

• ndims
  Anzahl der Dimensionen der kartesischen Struktur.

• Dims
  Ganzzahliges Array von Größen-ndims , das die Anzahl der Prozesse in jeder Koordinatenrichtung angibt.

• Zeiten
  Logisches Array von Größen-ndims , die die Periodizitätsspezifikation in jeder Koordinatenrichtung angeben.

• newrank [out]
  Neu sortierter Rang des aufrufenden Prozesses; MPI_UNDEFINED , wenn der Aufrufprozess nicht zum Raster gehört

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_MAP(COMM, NDIMS, DIMS, PERIODS, NEWRANK, IERROR)
        INTEGER COMM, NDIMS, DIMS(*), NEWRANK, IERROR
        LOGICAL PERIODS(*)

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