共用方式為

MPI_Cart_map 函式

  • 發行項

將進程對應至笛卡兒拓撲資訊。

語法

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

參數

  • 通訊
    輸入通訊器。

  • ndims
    笛卡兒結構的維度數目。

  • dims
    大小 ndims 的整數陣列，指定每個座標方向的進程數目。

  • 時期
    大小 ndims 的邏輯陣列，指定每個座標方向的週期性規格。

  • newrank [out]
    重新排序呼叫進程的排名;如果呼叫進程不屬於方格，MPI_UNDEFINED

傳回值

傳回成功時 MPI_SUCCESS 。 否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

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

規格需求

產品

HPC Pack 2012 MS-MPI 可轉散發套件、HPC Pack 2008 R2 MS-MPI 可轉散發套件、HPC Pack 2008 MS-MPI 可轉散發套件或 HPC Pack 2008 用戶端公用程式

標頭

 Mpi.h;Mpif.h

媒體櫃

 Msmpi.lib

DLL

 Msmpi.dll

另請參閱

MPI 進程拓撲函式