public class Cartcomm extends Intracomm
group, mpjdevComm
| Modifier and Type | Method and Description |
|---|---|
java.lang.Object |
clone()
Clone the communicator This method will be called only by intracommunicator ....
|
int[] |
Coords(int rank)
Translate process rank to logical process coordinates.
|
static void |
Dims_create(int nnodes, int[] dims)
Select a balanced distribution of processes per coordinate direction.
|
CartParms |
Get()
Returns Cartesian topology information.
|
int |
Map(int[] dims, boolean[] periods)
Compute an optimal placement.
|
int |
Rank(int[] coords)
Translate logical process coordinates to process rank.
|
ShiftParms |
Shift(int direction, int disp)
Compute source and destination ranks for ``shift'' communication.
|
Cartcomm |
Sub(boolean[] remain_dims)
Partition Cartesian communicator into subgroups of lower dimension.
|
int |
Topo_test()
Returns the type of topology associated with the communicator.
|
Allgather, Allgatherv, Allreduce, Alltoall, Alltoallv, Barrier, Bcast, Compare, Create_cart, Create_graph, Create, Gather, Gatherv, Reduce_scatter, Reduce, Scan, Scatter, Scatterv, Split
Abort, Attr_delete, Attr_get, Bsend_init, Bsend, bsend, Create_intercomm, Free, Group, Ibsend, ibsend, Iprobe, Irecv, irecv, Irsend, irsend, Isend, isend, Issend, issend, Pack_size, Pack, Probe, Rank, Recv_init, Recv, recv, Rsend_init, Rsend, rsend, Send_init, Send, send, Sendrecv_replace, sendrecv, Sendrecv, Size, Ssend_init, Ssend, ssend, Test_inter, Unpack
public java.lang.Object clone()
throws MPIException
Intracomm
clone in class Intracomm
MPIExceptionpublic int Rank(int[] coords)
throws MPIException
| coords | Cartesian coordinates of a process |
| returns: | rank of the specified process |
Java binding of the MPI operation MPI_CART_RANK.
MPIExceptionpublic int[] Coords(int rank)
throws MPIException
| rank | rank of a process |
| returns: | Cartesian coordinates of the specified process |
Java binding of the MPI operation MPI_CART_COORDS.
MPIExceptionpublic ShiftParms Shift(int direction, int disp) throws MPIException
| direction | coordinate dimension of shift |
| disp | displacement |
| returns: | object containing ranks of source and destination processes |
Java binding of the MPI operation MPI_CART_SHIFT.
MPIExceptionpublic Cartcomm Sub(boolean[] remain_dims) throws MPIException
| remain_dims | by dimension, true if dimension is to be kept, false otherwise |
| returns: | communicator containing subgrid including this process |
Java binding of the MPI operation MPI_CART_SUB.
MPIExceptionpublic int Map(int[] dims,
boolean[] periods)
throws MPIException
| dims | the number of processes in each dimension |
| periods | true if grid is periodic, false if not, in each dimension |
| returns: | reordered rank of calling process |
Java binding of the MPI operation MPI_CART_MAP.
The number of dimensions is taken to be size of the dims argument.
MPIExceptionpublic CartParms Get() throws MPIException
| returns: | object containing dimensions, periods and local coordinates |
Java binding of the MPI operations MPI_CARTDIM_GET and MPI_CART_GET.
The number of dimensions can be obtained from the size of (eg) dims field of the returned object.
MPIExceptionpublic int Topo_test()
throws MPIException
Comm
| returns: | topology type of communicator |
Java binding of the MPI operation MPI_TOPO_TEST.
The return value will be one of MPI.GRAPH, MPI.CART or MPI.UNDEFINED.
Topo_test in class Comm
MPIExceptionpublic static void Dims_create(int nnodes,
int[] dims)
throws MPIException
| nnodes | number of nodes in a grid |
| ndims | number of dimensions of grid |
| dims | array specifying the number of nodes in each dimension |
Java binding of the MPI operation MPI_DIMS_CREATE.
Size dims should be ndims. Note that dims is an inout parameter.
MPIException