MPI_Group_range_incl függvény

Egy csoportkonstruktor, amely egy új csoport meghatározására szolgál további ranghalmazok meglévő csoporthoz való hozzáadásával.

Szintaxis

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

Paraméterek

• hozzáadása
  A meglévő csoport.

• p
  A tömbtartományokban lévő hármasok száma.

• Tartományok
  Az új csoportba felvenni kívánt folyamatok specifikációinak tömbje. A tömb minden eleme három egész számból álló folyamattartományt ad meg az első rangsorhoz, az utolsó rangsorhoz és a lépéshez.

• newgroup [out]
  Az új csoportot jelképező fogópontra mutató mutató. Az új csoport a további ranghalmazokat tartalmazza. A sorrendet tartományok határozzák meg.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben lesz tárolva.

Fortran

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

Megjegyzések

Ha a tartományok a hármasok (első1 , utolsó1, stride1) , ..., (firstn, lastn, striden), majd az új csoport a csoportokban lévő folyamatok sorozatából áll, az első1, az első 1 + a stride1, a ..., a RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + striden, ..., RoundDown((lastn - firstn)/striden)*striden.

Minden kiszámított rangsornak érvényes rangnak kell lennie az új csoportban, és minden kiszámított rangsornak különnek kell lennie. Ellenkező esetben a függvény hibát ad vissza.

Megjegyzés

Vegye figyelembe, hogy a first[i] értéke nagyobb, mint az utolsó[i], a stride[i] pedig negatív lehet, de nem lehet nulla.

 

Ez egy helyi művelet. A különböző folyamatok különböző csoportokat definiálhatnak. A folyamatok definiálhatnak olyan csoportot, amely nem tartalmazza magát.

Az MPI-implementáció nem biztosít mechanizmust a csoportok nulláról történő létrehozásához, csak a meglévő csoportokból. Az alapcsoport, amelyre az összes többi csoport definiálva van, lekérhető a MPI_Comm_group függvénnyel. Ez az a csoport, amely a kezdeti kommunikátor MPI_COMM_WORLD van társítva.

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI terjeszthető csomag vagy HPC Pack 2008 Client Utilities
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI-csoportfüggvények

MPI_Group_incl

MPI_Comm_group