Modifier and Type | Field and Description |
---|---|
protected long |
handle |
Modifier | Constructor and Description |
---|---|
protected |
Group(long handle) |
Modifier and Type | Method and Description |
---|---|
static int |
compare(Group group1,
Group group2)
Compare two groups.
|
static Group |
difference(Group group1,
Group group2)
Set difference of two groups.
|
Group |
excl(int[] ranks)
Create a subset group excluding specified processes.
|
void |
free()
Java binding of the MPI operation
MPI_GROUP_FREE . |
protected static long |
getEmpty() |
int |
getRank()
Rank of this process in the group.
|
int |
getSize()
Java binding of the MPI operation
MPI_GROUP_SIZE . |
Group |
incl(int[] ranks)
Create a subset group including specified processes.
|
static Group |
intersection(Group group1,
Group group2)
Set intersection of two groups.
|
boolean |
isNull()
Test if group object is null.
|
Group |
rangeExcl(int[][] ranges)
Create a subset group excluding processes specified
by strided intervals of ranks.
|
Group |
rangeIncl(int[][] ranges)
Create a subset group including processes specified
by strided intervals of ranks.
|
static int[] |
translateRanks(Group group1,
int[] ranks1,
Group group2)
Translate ranks within one group to ranks within another.
|
static Group |
union(Group group1,
Group group2)
Set union of two groups.
|
protected static long getEmpty()
public int getSize() throws MPIException
MPI_GROUP_SIZE
.MPIException
- Signals that an MPI error of some sort has occurred.public int getRank() throws MPIException
Java binding of the MPI operation MPI_GROUP_RANK
.
MPI.UNDEFINED
if this process is not a member of the group.MPIException
- Signals that an MPI error of some sort has occurred.public void free() throws MPIException
MPI_GROUP_FREE
.free
in interface Freeable
MPIException
- Signals that an MPI error of some sort has occurred.public boolean isNull()
public static int[] translateRanks(Group group1, int[] ranks1, Group group2) throws MPIException
Java binding of the MPI operation MPI_GROUP_TRANSLATE_RANKS
.
Result elements are MPI.UNDEFINED
where no correspondence exists.
group1
- a groupranks1
- array of valid ranks in group1group2
- another groupMPIException
- Signals that an MPI error of some sort has occurred.public static int compare(Group group1, Group group2) throws MPIException
Java binding of the MPI operation MPI_GROUP_COMPARE
.
group1
- first groupgroup2
- second groupMPI.IDENT
if the group members and group order are exactly
the same in both groups, MPI.SIMILAR
if the group members are
the same but the order is different, MPI.UNEQUAL
otherwise.MPIException
- Signals that an MPI error of some sort has occurred.public static Group union(Group group1, Group group2) throws MPIException
Java binding of the MPI operation MPI_GROUP_UNION
.
group1
- first groupgroup2
- second groupMPIException
- Signals that an MPI error of some sort has occurred.public static Group intersection(Group group1, Group group2) throws MPIException
MPI_GROUP_INTERSECTION
.group1
- first groupgroup2
- second groupMPIException
- Signals that an MPI error of some sort has occurred.public static Group difference(Group group1, Group group2) throws MPIException
MPI_GROUP_DIFFERENCE
.group1
- first groupgroup2
- second groupMPIException
- Signals that an MPI error of some sort has occurred.public Group incl(int[] ranks) throws MPIException
Java binding of the MPI operation MPI_GROUP_INCL
.
ranks
- ranks from this group to appear in new groupMPIException
- Signals that an MPI error of some sort has occurred.public Group excl(int[] ranks) throws MPIException
Java binding of the MPI operation MPI_GROUP_EXCL
.
ranks
- ranks from this group not to appear in new groupMPIException
- Signals that an MPI error of some sort has occurred.public Group rangeIncl(int[][] ranges) throws MPIException
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.
ranges
- array of integer tripletsMPIException
- Signals that an MPI error of some sort has occurred.public Group rangeExcl(int[][] ranges) throws MPIException
Java binding of the MPI operation MPI_GROUP_RANGE_EXCL
.
Triplet array is defined as for rangeIncl
, the ranges
indicating ranks in this group to be excluded from the new group.
ranges
- array of integer tripletsMPIException
- Signals that an MPI error of some sort has occurred.