MPI_Cart_rank - Determines the process rank in the
       communicator, given the Cartesian location


SYNOPSIS

       C:

            #include <mpi.h>

            int MPI_Cart_rank ( comm, coords, rank )
            MPI_Comm comm;
            int *coords;
            int *rank;

       C++:

            #include <mpi.h>

            int Cartcomm::Get_rank() const

       Fortran:

            INCLUDE "mpif.h" (or USE MPI)

            INTEGER comm, coords(*), rank, ierror

            CALL MPI_CART_RANK(comm, coords(*), rank,
            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_rank routine determines the process rank in
       the communicator, given the Cartesian location.  This
       routine accepts the following parameters:

       comm      Specifies a communicator with Cartesian
                 structure (handle)

       coords    Specifies an integer array (of size ndims in the
                 MPI_Cart_create(3) routine), which specifies the
                 Cartesian coordinates of a process

       rank      Returns the rank of the specified process
                 (integer)

       ierror    Specifies the return code value for successful
                 completion, which is in MPI_SUCCESS.



SEE ALSO

       MPI_Cart_create(3)


Man(1) output converted with man2html