Freigeben über


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