funzione MPI_Gather
Raccoglie i dati da tutti i membri di un gruppo a un membro.
Sintassi
int MPIAPI MPI_Gather(
_In_ void *sendbuf,
int sendcount,
MPI_Datatype sendtype,
_Out_opt_ void *recvbuf,
int recvcount,
MPI_Datatype recvtype,
int root,
MPI_Comm comm
);
Parametri
sendbuf [in]
Puntatore a un buffer che contiene i dati da inviare al processo radice.Se il parametro comm fa riferimento a un intracommunicator, è possibile specificare un'opzione sul posto specificando MPI_IN_PLACE in tutti i processi. I parametri sendcount e sendtype vengono ignorati. Ogni processo immette i dati nell'elemento buffer di ricezione corrispondente. Il processo ninvia i dati all'elemento ndel buffer di ricezione. Si presuppone che i dati inviati dal processo radice siano nella posizione corretta nel buffer di ricezione.
sendcount
Numero di elementi nel buffer di invio. Se sendcount è zero, la parte dei dati del messaggio è vuota.sendtype
Tipo di dati di ogni elemento nel buffer.recvbuf [out, facoltativo]
Puntatore a un buffer nel processo radice contenente i dati ricevuti da ogni processo. Include i dati inviati dal processo radice. Questo parametro è significativo solo nel processo radice. Il parametro recvbuf viene ignorato per tutti i processi non radice.recvcount
Numero di elementi ricevuti da ogni processo. Questo numero non è il numero totale di elementi nel buffer. Se il conteggio è zero, la parte dei dati del messaggio è vuota. Questo parametro è significativo solo nel processo radice.recvtype
Tipo di dati MPI di ogni elemento nel buffer. Questo parametro è significativo solo nel processo radice.radice
Classificazione del processo di ricezione all'interno del comunicatore specificato.Comm
Handle del comunicatore MPI_Comm.
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_GATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, IERROR)
<type> SENDBUF(*), RECVBUF(*)
INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, ROOT, COMM, IERROR
Commenti
Tutti i parametri della funzione sono significativi nel processo radice, solo il sendbuf, sendcount, sendtype, root e comm sono significativi negli altri processi. I parametri radice e comm devono essere identici in tutti i processi.
In genere, i tipi di dati derivati sono consentiti per i parametri sendtype e recvtype . La firma del tipo specificata dai parametri sendtype e recvtype in ogni processo deve essere uguale alla firma del tipo dei parametri recvcount e sendcount nel processo radice. La quantità di dati inviati deve essere uguale alla quantità di dati ricevuti tra il processo radice e ogni singolo processo. Le mappe dei tipi distinti tra mittente e ricevitore sono ancora consentite.
La specifica dei conteggi e dei tipi non deve causare la scrittura di più posizioni nella radice. Tale chiamata è errata.
Se il parametro comm fa riferimento a un intracommunicator, tutti i processi inviano il contenuto del relativo buffer di invio al processo radice. Il processo radice riceve i messaggi e li archivia in ordine di classificazione. Il risultato è come se ognuno dei processi n del gruppo ha eseguito una chiamata a e la radice ha eseguito n chiamate a MPI_Recv(recvbuf + i*recvcount*extent(recvtype), recvcount, recvtype, i, …)MPI_Send(sendbuf, sendcount, sendtype, root, …). Il valore di extent(recvtype) viene ottenuto usando la funzione MPI_Type_get_extent . Una descrizione alternativa della funzione è che i n messaggi inviati dai processi nel gruppo vengono concatenati nell'ordine di classificazione e il messaggio risultante viene ricevuto dalla radice come se da una chiamata a MPI_RECV(recvbuf, recvcountn, recvtype, ...). Il buffer di ricezione viene ignorato per tutti i processi non radice.
Se il parametro comm fa riferimento a un intercommunicator, la chiamata comporta tutti i processi nell'intercommunicator, ma con un gruppo, un gruppo A, che definisce il processo radice. Tutti i processi nell'altro gruppo, gruppo B, impostano lo stesso valore nel parametro radice , ovvero il rango del processo radice nel gruppo A. Il processo radice imposta il valore MPI_ROOT nel parametro radice . Tutti gli altri processi nel gruppo A impostano il valore MPI_PROC_NULL nel parametro radice . I dati vengono trasmessi dal processo radice a tutti i processi nel gruppo B. I parametri del buffer dei processi nel gruppo B devono essere coerenti con il parametro buffer del processo radice.
Requisiti
Prodotto |
Pacchetto ridistribuibile HPC 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 |