MPI_Dims_create function

Creates a division of processors in a cartesian grid.

Syntax

int MPIAPI MPI_Dims_create(
   int                      nnodes,
   int                      ndims,
   _Inout_count_(ndims) int *dims
);

Parameters

• nnodes
  Number of nodes in a grid.

• ndims
  Number of cartesian dimensions.

• dims
  Integer array of size ndims specifying the number of nodes in each dimension. A value of 0 indicates that MPI_Dims_create should fill in a suitable value.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_DIMS_CREATE(NNODES, NDIMS, DIMS, IERROR)
        INTEGER NNODES, NDIMS, DIMS(*), IERROR

Requirements

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Library	Msmpi.lib
DLL	Msmpi.dll

See also

MPI Process Topology Functions