MPI_Group_incl functie
Hiermee maakt u een nieuwe groep die een subset van de processen in een bestaande groep bevat.
Syntaxis
int MPIAPI MPI_Group_incl(
MPI_Group group,
int n,
_In_count_(n) int *ranks,
_Out_ MPI_Group *newgroup
);
Parameters
groep
De bestaande groep.n
Het aantal elementen in de parameter ranks en de grootte van de nieuwe groep.Gelederen
De processen die moeten worden opgenomen in de nieuwe groep.newgroup [uit]
Een aanwijzer naar een ingang die de nieuwe groep vertegenwoordigt, die de opgenomen processen bevat in de volgorde waarin ze zijn opgegeven in de parameter ranks .
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_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR
Opmerkingen
Deze functie kan worden gebruikt om de volgorde van de elementen van een groep te wijzigen.
Dit is een lokale bewerking. Verschillende processen kunnen afzonderlijke groepen definiëren. Een proces kan een groep definiëren die zichzelf niet opneemt.
De MPI-implementatie biedt geen mechanisme om een volledig nieuwe groep te bouwen, maar alleen vanuit 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 |
HHPC 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 |