MPI_Group_range_incl funkce

Konstruktor skupiny, který se používá k definování nové skupiny přidáním dalších sad pořadí do existující skupiny.

Syntaxe

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

Parametry

• skupina
  Existující skupina

• n
  Počet trojic v oblastech pole.

• Rozsahy
  Pole specifikací procesů, které se mají zahrnout do nové skupiny. Každý prvek pole určuje rozsah procesu ve formě tří celých čísel pro první pořadí, poslední pořadí a krok.

• nová skupina [out]
  Ukazatel na úchyt, který představuje novou skupinu. Nová skupina obsahuje další sady pořadí. Pořadí je definováno rozsahy.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

Ve Fortranu je vrácená hodnota uložena v parametru IERROR .

Fortran

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

Poznámky

Pokud se rozsahy skládají z trojic (first1 , last1, stride1) , ..., (firstn, lastn, striden), pak se newgroup skládá z posloupnosti procesů ve skupině s pořadím first1, first1 + stride1, ..., RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + striden, ..., RoundDown((lastn - firstn)/striden)*striden.

Každé vypočítané pořadí musí být platným pořadím v nové skupině a všechna vypočítaná pořadí musí být odlišná. V opačném případě funkce vrátí chybu.

Poznámka

Všimněte si, že můžete nastavit první[i] větší než last[i] a krok[i] může být záporný, ale nemůže být nulový.

 

Jedná se o místní operaci. Různé procesy mohou definovat odlišné skupiny. Proces může definovat skupinu, která nezahrnuje sebe sama.

Implementace MPI neposkytuje mechanismus pro vytvoření skupiny od začátku, ale pouze z existujících skupin. Základní skupinu, ve které jsou definovány všechny ostatní skupiny, lze načíst pomocí funkce MPI_Comm_group . Jedná se o skupinu, která je přidružena k počátečnímu komunikátoru MPI_COMM_WORLD.

Požadavky

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities
Hlavička	Mpi.h; Soubor Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce skupiny MPI

MPI_Group_incl

MPI_Comm_group