MPI_Type_create_darray function

Creates a datatype representing a distributed array.

Syntax

int MPIAPI MPI_Type_create_darray(
        int                   size,
        int                   rank,
        int                   ndims,
        _In_count_(ndims) int array_of_gszies[],
        _In_count_(ndims) int array_of_distribs[],
        _In_count_(ndims) int array_of_dargs[],
        _In_count_(ndims) int array_of_psizes[],
        int                   order,
        MPI_Datatype          oldtype,
  _Out_ MPI_Datatype          *newtype
);

Parameters

• size
  Size of process group.

• rank
  Rank in process group.

• ndims
  Number of array dimensions as well as process grid dimensions.

• array_of_gszies
  Number of elements of type oldtype in each dimension of global array.

• array_of_distribs
  Distribution of array in each dimension.

• array_of_dargs
  Distribution argument in each dimension.

• array_of_psizes
  Size of process grid in each dimension.

• order
  Array storage order flag.

• oldtype
  Old datatype.

• newtype [out]
  New datatype.

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_TYPE_CREATE_DARRAY(SIZE, RANK, NDIMS, ARRAY_OF_GSIZES,
            ARRAY_OF_DISTRIBS, ARRAY_OF_DARGS, ARRAY_OF_PSIZES, ORDER,
            OLDTYPE, NEWTYPE, IERROR)
        INTEGER SIZE, RANK, NDIMS, ARRAY_OF_GSIZES(*), ARRAY_OF_DISTRIBS(*),
        ARRAY_OF_DARGS(*), ARRAY_OF_PSIZES(*), ORDER, OLDTYPE, NEWTYPE, IERROR

Requirements

See also

MPI Datatype Functions