MPI_Group_difference functie

Hiermee maakt u een nieuwe groep op basis van het verschil tussen twee bestaande groepen.

Syntaxis

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

Parameters

• groep1
  De eerste groep.

• groep2
  De tweede groep.

• newgroup [out]
  Een verwijzing naar een ingang die een nieuwe groep vertegenwoordigt die alle elementen in de eerste groep bevat die niet aanwezig zijn in de tweede groep. De functie retourneert MPI_GROUP_EMPTY als de nieuwe groep leeg is.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_GROUP_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Opmerkingen

Dit is een lokale bewerking. Verschillende processen kunnen afzonderlijke groepen definiëren. Een proces kan een groep definiëren die zichzelf niet omvat.

De MPI-implementatie biedt geen mechanisme om een volledig nieuwe groep op te bouwen, maar alleen op basis van bestaande groepen. De basisgroep, waarop alle andere groepen zijn gedefinieerd, kan worden opgehaald met behulp van de functie MPI_Comm_group . Het is de groep die is gekoppeld aan de eerste communicator-MPI_COMM_WORLD.

Vereisten

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliotheek	Msmpi.lib
DLL	Msmpi.dll

Zie ook

MPI-groepsfuncties

MPI_Comm_group