MPI_Group_intersection funkce

Vytvoří novou skupinu z průsečíku dvou existujících skupin.

Syntaxe

int MPIAPI MPI_Group_intersection(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

Parametry

• skupina1
  První skupina.

• skupina2
  Druhá skupina.

• newgroup [out]
  Ukazatel na úchyt, který představuje novou skupinu s prvky, které jsou přítomné v obou skupinách. Funkce vrátí MPI_GROUP_EMPTY , pokud je nová skupina prázdná.

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_INTERSECTION(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Poznámky

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

Viz také

Funkce skupiny MPI

MPI_Comm_group