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

参数

  • comm
    输入通信器。

  • 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 进程拓扑函数