MPI_Cart_rank(3)

NAME
     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.  MPI_SUCCESS is defined in the mpif.h
               file.

SEE ALSO
     MPI_Cart_create(3)