funktionen MPI_Group_range_incl

En gruppkonstruktor som används för att definiera en ny grupp genom att lägga till ytterligare uppsättningar rangordningar i en befintlig grupp.

Syntax

int MPIAPI MPI_Group_range_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int ranges[][3],
  _Out_ MPI_Group         *newgroup
);

Parametrar

• grupp
  Den befintliga gruppen.

• n
  Antalet trillingar i matrisintervall.

• Spänner
  En matris med specifikationer för processer som ska ingå i den nya gruppen. Varje element i matrisen anger ett processintervall i form av tre heltal för den första rangordningen, den sista rangordningen och steget.

• newgroup [out]
  En pekare till ett handtag som representerar den nya gruppen. Den nya gruppen innehåller de ytterligare uppsättningarna med rangordningar. Ordningen definieras av intervall.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_GROUP_RANGE_INCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Kommentarer

Om intervall består av trillingarna (första1 , sista1, steg 1) , ..., (firstn, lastn, striden), består newgroup av sekvensen av processer i grupp med rang först1, first1 + stride1, ..., RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + strid, ..., RoundDown((lastn - firstn)/striden)*striden.

Varje beräknad rangordning måste vara en giltig rangordning i den nya gruppen och alla beräknade rang måste vara distinkta. Annars returnerar funktionen ett fel.

Anteckning

Observera att du kan ange först[i] större än sist[i], och steg[i] kan vara negativa, men det får inte vara noll.

 

Det här är en lokal åtgärd. Olika processer kan definiera distinkta grupper. En process kan definiera en grupp som inte innehåller sig själv.

MPI-implementeringen tillhandahåller ingen mekanism för att skapa en grupp från grunden, utan bara från befintliga grupper. Basgruppen, som alla andra grupper har definierats för, kan hämtas med hjälp av funktionen MPI_Comm_group . Det är den grupp som är associerad med den första kommunikationsappen MPI_COMM_WORLD.

Krav

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities
Huvud	Mpi.h; Mpif.h
Bibliotek	Msmpi.lib
DLL	Msmpi.dll

Se även

MPI-gruppfunktioner

MPI_Group_incl

MPI_Comm_group