MPI_GROUP_RANGE_INCL(3)MPI_GROUP_RANGE_INCL(3)NAMEMPI_Group_range_incl - Creates a new group from ranges of ranks in an
existing group
SYNOPSIS
C:
#include <mpi.h>
int MPI_Group_range_incl ( group, n, ranges, newgroup )
MPI_Group group, *newgroup;
int n, ranges[][3];
C++:
#include <mpi.h>
Group Group::Range_incl(
int n,
const int ranges[3][]) const
Fortran:
INCLUDE "mpif.h" (or USE MPI)
INTEGER group, n, ranges(3,*), newgroup, ierror
CALL MPI_GROUP_RANGE_INCL(group, n, ranges(3,*), newgroup, 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_Group_range_incl routine creates a new group from ranges of ranks
in an existing group. This routine accepts the following parameters:
group Specifies the group (handle)
n Specifies the number of triplets in array ranges (integer)
ranges Specifies a one-dimensional array of integer triplets, of the
form "first rank, last rank, stride," indicating ranks in the
group or processes to be included in newgroup
newgroup Returns a new group derived from group, in the order defined by
ranges (handle)
Page 1
MPI_GROUP_RANGE_INCL(3)MPI_GROUP_RANGE_INCL(3)
ierror Specifies the return code value for successful completion,
which is in MPI_SUCCESS. MPI_SUCCESS is defined in the mpif.h
file.
NOTES
Currently, this implementation does not check to determine if the list of
ranges to include are valid ranks in the group.
Page 2