|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object mpi.Group
public class Group
Method Summary | |
---|---|
static int |
Compare(Group group1,
Group group2)
Compare two groups. |
static Group |
Difference(Group group1,
Group group2)
Makes a group from the difference of two groups. |
Group |
Excl(int[] ranks)
Create a subset group excluding specified processes. |
void |
finalize()
Destroy this group. |
Group |
Incl(int[] ranks)
Create a subset group including specified processes. |
static Group |
Intersection(Group group1,
Group group2)
Set intersection of two groups. |
Group |
Range_excl(int[][] ranges)
Create a subset group excluding processes speci ed by strided intervals of ranks. |
Group |
Range_incl(int[][] ranges)
Create a subset group including processes specified by strided intervals of ranks. |
int |
Rank()
Rank of this process in group. |
int |
Size()
Returns the size of the group. |
static int[] |
Translate_ranks(Group group1,
int[] ranks1,
Group group2)
Translate ranks within first group to ranks within second group. |
static Group |
Union(Group group1,
Group group2)
Set union of two groups. |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public int Size() throws MPIException
returns: | number of processes in the group |
Java binding of the MPI operation MPI_GROUP_SIZE.
MPIException
public int Rank() throws MPIException
returns: | rank of the calling process in the group |
Java binding of the MPI operation MPI_GROUP_RANK.
Result value is MPI.UNDEFINED if this process is not a member of the group.
MPIException
public static int[] Translate_ranks(Group group1, int[] ranks1, Group group2) throws MPIException
group1 | first group |
ranks1 | array of valid ranks in group1 |
group2 | second group |
returns: | array of corresponding ranks in group2, MPI_UNDEFINED when no correspondence exists. |
Java binding of the MPI operation MPI_GROUP_TRANSLATE_RANKS.
MPIException
public static int Compare(Group group1, Group group2) throws MPIException
group1 | first group |
group2 | second group |
returns: | result |
Java binding of the MPI operation MPI_GROUP_COMPARE.
MPI.IDENT results if the group members and group order are exactly the same in both groups. MPI.SIMILAR results if the group members are the same but the order is different. MPI.UNEQUAL results otherwise.
MPIException
public static Group Union(Group group1, Group group2) throws MPIException
group1 | first group |
group2 | second group |
returns: | union group |
Java binding of the MPI operation MPI_GROUP_UNION.
Produces a group by combining the two input groups.
MPIException
public static Group Intersection(Group group1, Group group2) throws MPIException
group1 | first group |
group2 | second group |
returns: | intersection group |
Java binding of the MPI operation MPI_GROUP_INTERSECTION.
The output group contains those processes that are in both group1 and group2.
MPIException
public static Group Difference(Group group1, Group group2) throws MPIException
group1 | first group |
group2 | second group |
returns: | difference group |
Java binding of the MPI operation MPI_GROUP_DIFFERENCE.
Result contains all elements of the first group that are not in the second group.
MPIException
public Group Incl(int[] ranks) throws MPIException
ranks | ranks from this group to appear in new group |
returns: | new group |
Java binding of the MPI operation MPI_GROUP_INCL.
This method returns a new group object including all the ranks specified in the argument array. Each item of the argument array should be a valid rank in the calling group. The total number of items in argument array should not be more than the size of the existing group. This method is a local operation.
MPIException
public Group Excl(int[] ranks) throws MPIException
ranks | ranks from this group not to appear in new group |
returns: | new group |
Java binding of the MPI operation MPI_GROUP_EXCL.
This method returns a new group object excluding all the ranks specified in the argument array. Each item of the argument array should be a valid rank in the calling group. The total number of items in argument array should not be more than the size of the existing group. This method is a local operation.
MPIException
public Group Range_incl(int[][] ranges) throws MPIException
ranges | array of integer triplets |
returns: | new group |
Java binding of the MPI operation MPI_GROUP_RANGE_INCL.
The triplets are of the form (first rank, last rank, stride) indicating ranks in this group to be included in the new group. The size of the first dimension of ranges is the number of triplets. The size of the second dimension is 3.
MPIException
public Group Range_excl(int[][] ranges) throws MPIException
ranges | array of integer triplets |
returns: | new group |
Java binding of the MPI operation MPI_GROUP_RANGE_EXCL.
Triplet array is defined as for Range_incl, the ranges indicating ranks in this group to be excluded from the new group.
MPIException
public void finalize() throws MPIException
Java binding of the MPI operation MPI_GROUP_FREE.
finalize
in class java.lang.Object
MPIException
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |