funktionen MPI_Group_intersection

Skapar en ny grupp från skärningspunkten för två befintliga grupper.

Syntax

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

Parametrar

  • group1
    Den första gruppen.

  • group2
    Den andra gruppen.

  • newgroup [out]
    En pekare till en referens som representerar en ny grupp med de element som finns i båda grupperna. Funktionen returnerar MPI_GROUP_EMPTY om den nya gruppen är tom.

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

Kommentarer

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_Comm_group