MPI_CART_RANK(3)MPI_CART_RANK(3)NAMEMPI_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)
Page 1
MPI_CART_RANK(3)MPI_CART_RANK(3)
ierror Specifies the return code value for successful completion,
which is in MPI_SUCCESS. MPI_SUCCESS is defined in the mpif.h
file.
SEE ALSOMPI_Cart_create(3)
Page 2