共用方式為


MPI_Cart_create函式

建立已附加拓撲資訊的新通訊器。

語法

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

參數

  • comm_old
    輸入通訊器。

  • ndims
    笛卡兒方格的維度數目。

  • dims
    大小 ndims 的整數陣列,指定每個維度中的進程數目。

  • 時期
    大小為 ndims 的邏輯陣列,指定格線是否定期 (true) 或未在每個維度中 (false) 。

  • 排序
    排名可能會重新排序 (true) ,或不是 (false) 。

  • comm_cart [out]
    具有新笛卡兒拓撲的 Communicator。

傳回值

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

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

Fortran

    MPI_CART_CREATE(COMM_OLD, NDIMS, DIMS, PERIODS, REORDER, COMM_CART, IERROR)
        INTEGER COMM_OLD, NDIMS, DIMS(*), COMM_CART, IERROR
        LOGICAL PERIODS(*), REORDER

規格需求

產品

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 進程拓撲函式