MPI_Group_incl funkce

Vytvoří novou skupinu, která obsahuje podmnožinu procesů v existující skupině.

Syntaxe

int MPIAPI MPI_Group_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Parametry

• skupina
  Existující skupina.

• n
  Počet prvků v parametru řad a velikost nové skupiny.

• Řad
  Procesy, které se mají zahrnout do nové skupiny.

• newgroup [out]
  Ukazatel na popisovač, který představuje novou skupinu, která obsahuje zahrnuté procesy v pořadí, ve kterém jsou zadány v parametru řad .

Vrácená hodnota

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

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

    MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Poznámky

Tuto funkci lze použít ke změně pořadí prvků skupiny.

Toto je místní operace. Různé procesy můžou definovat různé 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, pro kterou jsou definovány všechny ostatní skupiny, lze načíst pomocí funkce MPI_Comm_group . Jedná se o skupinu, která je přidružená k počátečnímu MPI_COMM_WORLD komunikátoru.

Požadavky

Produkt	HHPC 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; Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce skupiny MPI

MPI_Comm_group