MPI_Group_incl fonction
Crée un groupe qui contient un sous-ensemble des processus d’un groupe existant.
Syntaxe
int MPIAPI MPI_Group_incl(
MPI_Group group,
int n,
_In_count_(n) int *ranks,
_Out_ MPI_Group *newgroup
);
Paramètres
groupe
Groupe existant.n
Nombre d’éléments dans le paramètre de classements et taille du nouveau groupe.Rangs
Processus à inclure dans le nouveau groupe.newgroup [out]
Pointeur vers un handle qui représente le nouveau groupe, qui contient les processus inclus dans l’ordre dans lequel ils sont spécifiés dans le paramètre ranks .
Valeur retournée
Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.
Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .
Fortran
MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR
Remarques
Cette fonction peut être utilisée pour réorganiser les éléments d’un groupe.
Il s’agit d’une opération locale. Différents processus peuvent définir des groupes distincts. Un processus peut définir un groupe qui ne s’inclut pas lui-même.
L’implémentation MPI ne fournit pas de mécanisme pour créer un groupe à partir de zéro, mais uniquement à partir de groupes existants. Le groupe de base, sur lequel tous les autres groupes sont définis, peut être récupéré à l’aide de la fonction MPI_Comm_group . Il s’agit du groupe associé au MPI_COMM_WORLD de communication initial.
Configuration requise
Produit |
HHPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities |
En-tête |
Mpi.h ; Mpif.h |
Bibliothèque |
Msmpi.lib |
DLL |
Msmpi.dll |