MPI_Cart_create

MPI_Cart_create defines a Cartesian virtual topology.

C

int MPI_Cart_create(MPI_Comm comm_old, int ndims, 
                    int *dims, int *periods, int reorder, 
                    MPI_Comm *comm_cart)

Fortran

MPI_CART_CREATE(COMM_OLD, NDIMS, DIMS, PERIODS, REORDER, COMM_CART, IERROR)
    INTEGER COMM_OLD, NDIMS, DIMS(*), COMM_CART, IERROR
    LOGICAL PERIODS(*), REORDER

Arguments:

comm_old

existing communicator

ndims

number of dimensions

periods

logical array indicating whether a dimension is cyclic
(TRUE means cyclic boundary conditions)

reorder

FALSE means rank preserved; TRUE means possible rank reordering

comm_cart

the new Cartesian communicator