funktionen MPI_Alltoallw

Artikel
01/16/2024

Samlar in data från och sprider data till alla medlemmar i en grupp. Funktionen MPI_Alltoallw är den mest allmänna formen av fullständigt datautbyte i det här API:et. MPI_Alltoallw möjliggör separat specifikation av antal, deplacement och datatyp.

Syntax

int MPIAPI MPI_Alltoallw(
  _In_  void         *sendbuf,
  _In_  int          *sendcounts[],
  _In_  int          *sdispls[],
  _In_  MPI_Datatype sendtypes[],
  _Out_ void         *recvbuf,
  _In_  int          *recvcounts[],
  _In_  int          *rdispls[],
  _In_  MPI_Datatype recvtypes[],
        MPI_Comm     comm
);

Parametrar

sendbuf [in]
Pekaren till de data som ska skickas till alla processer i gruppen. Antalet och datatypen för elementen i bufferten anges i parametrarna sendcount och sendtype . Varje element i bufferten motsvarar en process i gruppen.

Om comm-parametern refererar till en intracommunicator kan du ange ett alternativ på plats genom att ange MPI_IN_PLACE i alla processer. Parametrarna sendcount, sdispls och sendtype ignoreras. Varje process anger data i motsvarande mottagningsbuffertelement.

Data som skickas och tas emot måste ha samma typkarta, som anges av matrisen recvcounts och parametern recvtype , och läsas från platserna för mottagningsbufferten enligt parametern rdispls .
sendcounts [in]
Antalet dataelement som den här processen skickar i bufferten enligt vad som anges i parametern sendbuf . Om ett element i sendcount är noll är datadelen av meddelandet från den processen tom.
sdispls [in]
Platsen i byte, i förhållande till parametern sendbuf , för data för varje kommunikatorprocess.

Post j anger förskjutningen i förhållande till parametern sendbuf som de utgående data som är avsedda för process j ska tas från.
sendtypes [in]
Datatypen för vart och ett av elementen i sändningsbufferten. Post j anger vilken typ av data som skickas för att bearbeta j i gruppen.
recvbuf [out]
Pekaren till en buffert som innehåller de data som tas emot från varje process. Antalet och datatypen för elementen i bufferten anges i parametrarna recvcount och recvtype .
recvcounts [in]
Antalet dataelement från varje kommunikationsprocess i mottagningsbufferten.
rdispls [in]
Platsen i byte i förhållande till parametern recvbuf för data från varje kommunikatorprocess. Post i anger deplacementet i förhållande till parametern recvbuf där inkommande data ska placeras från process i.

I parametermatriserna recvbuf, recvcounts och rdispls refererar det n:e elementet i varje matris till de data som tas emot från den n:e kommunikatorprocessen.
recvtypes [in]
Datatypen för varje element i bufferten. Post i anger vilken typ av data som tas emot från process i.
Comm
MPI_Comm communicator-handtaget.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_ALLTOALLW(SENDBUF, SENDCOUNT, SDISPLS, SENDTYPE, RECVBUF, RECVCOUNTS, RDISPLS, RECVTYPE,COMM, IERROR)
        <type> SENDBUF(*), R.ECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPES(*), SDISPLS(*), RECVCOUNTS(*), RDISPLS(*), RECVTYPE, COMM, IERROR

Kommentarer

Viktigt

För att tillåta maximal flexibilitet anges deplacementen för block i sändnings- och mottagningsbuffertarna i byte.

Alla parametrar är viktiga för alla processer. Kommaparametern måste vara identisk i alla processer.

Om comm-parametern refererar till en intracommunicator tas det j:e blocket som skickas från processen i emot av process j och placeras i det i:e blocket i mottagningsbufferten. Alla dessa block behöver inte ha samma storlek.

Typsignaturen som anges av parametrarna sendcounts[j] och sendtypes[j] för process i måste vara lika med den typsignatur som är associerad med recvcounts[i] och recvtypes[i] vid process j. Därför måste mängden data som skickas vara lika med mängden data som tas emot mellan alla processer. Distinkta typkartor mellan avsändare och mottagare tillåts fortfarande.

Resultatet av ett anrop till funktionen MPI_Alltoallw är som om varje process skickade ett meddelande till alla andra processer med MPI_Send(sendbuf+sdispls[i],sendcounts[i],sendtypes[i] ,i,...)och tog emot ett meddelande från alla andra processer med ett anrop till MPI_Recv(recvbuf+rdispls[i],recvcounts[i],recvtypes[i] ,i,...).

Om du anger alternativet på plats anger du att samma mängd och typ av data skickas och tas emot mellan två processer i kommunikatörsgruppen. Olika processpar kan utbyta olika mängder data. Användarna måste se till att recvcounts[j] och recvtype på process jag matchar recvcounts[i] och recvtype på process j.

Om comm-parametern refererar till en intercommunicator är resultatet som om varje process i grupp A skickar ett meddelande till varje process i grupp B och vice versa. J: e skicka buffert av process i i grupp A bör vara konsekvent med ith ta emot bufferten av process j i grupp B, och vice versa.

Krav

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities
Huvud	Mpi.h; Mpif.h
Bibliotek	Msmpi.lib
DLL	Msmpi.dll