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]
    具有新笛卡尔拓扑的通信器。

返回值

返回成功 时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 进程拓扑函数