MPI_Cart_create - Makes a new communicator to which
       topology information has been attached


SYNOPSIS

       C:

            #include <mpi.h>

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

            MPI_Comm  comm_old;
            int       ndims;
            int      *dims;
            int      *periods;
            int       reorder;
            MPI_Comm *comm_cart;

       C++:

            #include <mpi.h>

            Cartcomm Intracomm::Create_cart(
            int               ndims,
            const int         dims[],
            const bool        periods[],
            bool              reorder) const

       Fortran:

            INCLUDE "mpif.h" (or USE MPI)

            INTEGER comm_old, ndims, dims(*), comm_cart,
            ierror
            LOGICAL periods(*), reorder

            CALL MPI_CART_CREATE(comm_old, ndims, dims(*),
            periods(*), reorder, comm_cart, ierror)


STANDARDS

       This release implements the MPI 1.2 standard, as
       documented by the MPI Forum in the spring 1997 release of
       MPI:  A Message Passing Interface Standard.


DESCRIPTION

       The MPI_Cart_create routine makes a new communicator to
       which topology information has been attached.  This
       routine accepts the following parameters:

       comm_old       Specifies the input communicator (handle)

                      Cartesian grid (integer)

       dims           Specifies the integer array of size ndims,
                      which specifies the number of processes in
                      each dimension

       periods        Specifies a logical array of size ndims,
                      which specifies whether the grid is
                      periodic (true) or not (false) in each
                      dimension

       reorder        Specifies that ranking can be reordered
                      (true) or not (false) (logical)

       comm_cart      Returns a communicator with new Cartesian
                      topology (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

       Currently, the periods are ignored and information is
       reordered.


Man(1) output converted with man2html