MPI_Group_range_excl functie
Hiermee maakt u een nieuwe groep door processen uit een bestaande groep te verwijderen.
Syntaxis
int MPIAPI MPI_Group_range_excl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
Parameters
groep
De bestaande groep.n
Het aantal bereiken van processen dat moet worden uitgesloten van de nieuwe groep.Bereiken
Een matrix met specificaties van processen die moeten worden uitgesloten van de bestaande groep. Elk element van de matrix geeft een procesbereik op in de vorm van drie gehele getallen voor de eerste rang, laatste rang en stap.newgroup [out]
Een verwijzing naar een ingang die de nieuwe groep vertegenwoordigt die de processen bevat die niet zijn uitgesloten. De volgorde van de groep blijft behouden.
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_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
Opmerkingen
Elke berekende rang moet een geldige rang in de bestaande groep zijn en alle berekende rangschikkingen moeten verschillend zijn; anders retourneert de functie een fout.
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 |