MPI_Gather függvény

Adatokat gyűjt a csoport összes tagjától egy tagig.

Szintaxis

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
);

Paraméterek

• sendbuf [in]
  Az egérmutató egy pufferre, amely tartalmazza a gyökérfolyamatba küldendő adatokat.

  Ha a komm paraméter egy intrakommunikátorra hivatkozik, a MPI_IN_PLACE minden folyamathoz megadhat egy helyi beállítást. A sendcount és a sendtype paraméterek figyelmen kívül lesznek hagyva. Minden folyamat adatokat ad meg a megfelelő fogadási pufferelemben. Az n. folyamat adatokat küld a fogadópuffer n. elemének. A gyökérfolyamat által küldött adatok feltételezik, hogy a fogadó pufferben a megfelelő helyen találhatóak.

• sendcount
  A küldési puffer elemeinek száma. Ha a sendcount értéke nulla, az üzenet adatrésze üres.

• sendtype
  A puffer egyes elemeinek adattípusa.

• recvbuf [ki, nem kötelező]
  Az egyes folyamatoktól kapott adatokat tartalmazó gyökérfolyamat pufferére mutató mutató. Ide tartoznak a gyökérfolyamat által küldött adatok. Ez a paraméter csak a gyökérfolyamatban jelentős. A recvbuf paraméter minden nem gyökérfolyamat esetében figyelmen kívül lesz hagyva.

• recvcount
  Az egyes folyamatoktól kapott elemek száma. Ez a szám nem a pufferben lévő elemek teljes száma. Ha a szám nulla, az üzenet adatrésze üres. Ez a paraméter csak a gyökérfolyamatban jelentős.

• recvtype
  A puffer egyes elemeinek MPI-adattípusa. Ez a paraméter csak a gyökérfolyamatban jelentős.

• Gyökér
  A fogadó folyamat rangja a megadott kommunikátorban.

• Comm
  A MPI_Comm communicator leírója.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben lesz tárolva.

Fortran

    MPI_GATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, ROOT, COMM, IERROR

Megjegyzések

Minden függvényparaméter jelentős a gyökérfolyamatban, csak a sendbuf, a sendcount, a sendtype, a root és a comm jelentős a többi folyamat esetében. A gyökér- és a comm-paramétereknek minden folyamat esetében azonosnak kell lenniük.

A származtatott adattípusok általában mind a sendtype , mind a recvtype paraméterek esetében engedélyezettek. Az egyes folyamatok sendtype és recvtype paraméterei által megadott típusadminiszt-aláírásnak meg kell egyeznie a recvcount és a sendcount paraméterek típus-aláírásával a gyökérfolyamatban. Az elküldött adatok mennyiségének meg kell egyeznie a gyökérfolyamat és az egyes folyamatok között fogadott adatok mennyiségével. A feladó és a fogadó közötti különböző típusleképek továbbra is engedélyezettek.

A számok és a típusok specifikációja nem okozhatja, hogy a gyökérkönyvtárban lévő helyeket egynél többször kell megírni. Egy ilyen hívás téves.

Ha a komm paraméter egy intrakommunikátorra hivatkozik, minden folyamat elküldi a küldési puffer tartalmát a gyökérfolyamatnak. A gyökérfolyamat fogadja az üzeneteket, és rangsor sorrendben tárolja őket. Az eredmény olyan, mintha a csoport minden n folyamata végrehajtott volna egy hívást a következőre MPI_Send(sendbuf, sendcount, sendtype, root, …): ; és a gyökér n hívásokat hajtott végre a következőre MPI_Recv(recvbuf + i*recvcount*extent(recvtype), recvcount, recvtype, i, …): . Az érték extent(recvtype) a MPI_Type_get_extent függvénnyel lesz lekért. A függvény alternatív leírása, hogy a csoportban lévő folyamatok által küldött n üzenetek sorrendben vannak összefűzve, és az eredményül kapott üzenetet a gyökér fogadja, mintha egy hívás a következőre MPI_RECV(recvbuf, recvcountn, recvtype, ...)hív. A fogadó puffer figyelmen kívül lesz hagyva minden nem gyökérfolyamat esetében.

Ha a komm paraméter egy interkommunikátorra hivatkozik, akkor a hívás magában foglalja az interkommunikátor összes folyamatát, de egy olyan csoporttal, az A csoporttal, amely meghatározza a gyökérfolyamatot. A másik csoport összes folyamata, a B csoport, ugyanazt az értéket állítja be a gyökérparaméterben, azaz az A csoport gyökérfolyamatának rangját. A gyökérfolyamat beállítja a gyökérparaméterben MPI_ROOT értéket. Az A csoport összes többi folyamata beállítja a gyökérparaméterben MPI_PROC_NULL értéket. Az adatok a gyökérfolyamatból a B csoport összes folyamatára lesznek továbbítva. A B csoportban lévő folyamatok pufferparamétereinek összhangban kell lenniük a gyökérfolyamat pufferparaméterével.

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI terjeszthető csomag vagy HPC Pack 2008 Client Utilities
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI kollektív függvények

MPI_Datatype

MPI_Gatherv