MPI_Cart_create-Funktion

Artikel
12/27/2023

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

Freigeben über