MPI_Type_create_darray - Creates a data type corresponding
to a distributed, multidimensional array
SYNOPSIS
C:
#include "mpi.h"
int MPI_Type_create_darray(int size, int rank, int ndims,
int *array_of_gsizes, int *array_of_distribs,
int *array_of_dargs, int *array_of_psizes, int order,
MPI_Datatype oldtype, MPI_Datatype *newtype)
Fortran:
include "mpif.h" (or USE MPI)
INTEGER size, rank, ndims, array_of_gsizes(*),
array_of_distribs(*), array_of_dargs(*), array_of_psizes(*),
order, oldtype, newtype, ierror
CALL MPI_TYPE_CREATE_DARRAY(size, rank, ndims,
array_of_gsizes, array_of_distribs, array_of_dargs,
array_of_psizes, order, oldtype, newtype, ierror)
DESCRIPTION
MPI_Type_create_darray creates a data type corresponding
to a distributed, multidimensional array. This routine
can be used to generate the data types corresponding to
the distribution of an ndims-dimensional array of oldtype
elements onto an ndims-dimensional grid of logical
processes. Unused dimensions of array_of_psizes should be
set to 1. For a call to MPI_Type_create_darray to be
correct, the equation must be satisfied. The ordering of
processes in the process grid is assumed to be row-major,
as in the case of virtual Cartesian process topologies in
MPI-1.
MPI_Type_create_darray accepts the following arguments:
size Specifies the size of the process group
(positive integer)
rank Specifies the rank in the process group
(nonnegative integer)
ndims Specifies the number of array dimensions as
well as process grid dimensions (positive
integer)
Specifies the number of elements of type
oldtype in each dimension of the global
array (array of positive integers)
array_of_distribs
Specifies the distribution of the array in
each dimension (array of state)
array_of_dargs Specifies the distribution argument in each
dimension (array of positive integers)
array_of_psizes
Specifies the size of the process grid in
each dimension (array of positive integers)
order Specifies the array storage order flag
(state)
oldtype Specifies the old data type (handle)
newtype Returns the new data type (handle)
ierror Specifies the return code value for
successful completion, which is in
MPI_SUCCESS. MPI_SUCCESS is defined in the
mpif.h file.
Notes for Fortran
All MPI objects (for example, MPI_Datatype, MPI_Comm,
MPI_File) are of type INTEGER.
SEE ALSO
MPI_Type_create_subarray(3)
Man(1) output converted with
man2html