MPI_Group_range_excl fonction
Crée un groupe en supprimant les processus d’un groupe existant.
Syntaxe
int MPIAPI MPI_Group_range_excl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
Paramètres
groupe
Groupe existant.n
Nombre de plages de processus à exclure du nouveau groupe.Gammes
Tableau de spécifications de processus à exclure du groupe existant. Chaque élément du tableau spécifie une plage de processus sous la forme de trois entiers pour le premier rang, le dernier rang et la foulée.newgroup [out]
Pointeur vers un handle qui représente le nouveau groupe qui contient les processus qui n’ont pas été exclus. L’ordre du groupe est conservé.
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_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
Remarques
Chaque classement calculé doit être un rang valide dans le groupe existant et tous les rangs calculés doivent être distincts ; sinon, la fonction retourne une erreur.
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 |
HpC 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 |