Edit

MPI_Dims_create function

  • Article

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