funktionen MPI_Cart_map

Mappar process till kartesisk topologiinformation.

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

Parametrar

• Comm
  Indatakommunikatör.

• ndims
  Antal dimensioner av kartesisk struktur.

• Dims
  Heltalsmatris med storleksmått som anger antalet processer i varje koordinatriktning.

• Perioder
  Logisk matris med storleksndims som anger periodicitetsspecifikationen i varje koordinatriktning.

• newrank [ut]
  omordnad rangordning för samtalsprocessen. MPI_UNDEFINED om samtalsprocessen inte tillhör rutnätet

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_CART_MAP(COMM, NDIMS, DIMS, PERIODS, NEWRANK, IERROR)
        INTEGER COMM, NDIMS, DIMS(*), NEWRANK, IERROR
        LOGICAL PERIODS(*)

Krav

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities
Huvud	Mpi.h; Mpif.h
Bibliotek	Msmpi.lib
DLL	Msmpi.dll

Se även

MPI-processtopologifunktioner