funzione MPI_Group_incl
Crea un nuovo gruppo che contiene un subset dei processi in un gruppo esistente.
Sintassi
int MPIAPI MPI_Group_incl(
MPI_Group group,
int n,
_In_count_(n) int *ranks,
_Out_ MPI_Group *newgroup
);
Parametri
utenti
Gruppo esistente.n
Numero di elementi nel parametro di classificazione e dimensioni del nuovo gruppo.Ranghi
I processi da includere nel nuovo gruppo.newgroup [out]
Puntatore a un handle che rappresenta il nuovo gruppo, che contiene i processi inclusi nell'ordine specificato nel parametro di classificazione .
Valore restituito
Restituisce MPI_SUCCESS sull'esito positivo. In caso contrario, il valore restituito è un codice di errore.
In Fortran il valore restituito viene archiviato nel parametro IERROR .
Fortran
MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR
Commenti
Questa funzione può essere usata per riordinare gli elementi di un gruppo.
Si tratta di un'operazione locale. I diversi processi possono definire gruppi distinti. Un processo può definire un gruppo che non include se stesso.
L'implementazione MPI non fornisce un meccanismo per creare un gruppo da zero, ma solo da gruppi esistenti. Il gruppo di base, al quale sono definiti tutti gli altri gruppi, può essere recuperato usando la funzione MPI_Comm_group . È il gruppo associato al comunicatore iniziale MPI_COMM_WORLD.
Requisiti
Prodotto |
Pacchetto ridistribuibile HHPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |