função MPI_Alltoallw

Artigo
01/16/2024

Recolhe dados de e dispersão de dados para todos os membros de um grupo. A função MPI_Alltoallw é a forma mais geral de troca de dados completa nesta API. MPI_Alltoallw permite especificações separadas da contagem, deslocamento e tipo de dados.

Sintaxe

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

Parâmetros

sendbuf [in]
O ponteiro para os dados a enviar para todos os processos no grupo. O número e o tipo de dados dos elementos na memória intermédia são especificados nos parâmetros sendcount e sendtype . Cada elemento na memória intermédia corresponde a um processo no grupo.

Se o parâmetro de comunicação fizer referência a um intracomunicador, pode especificar uma opção no local ao especificar MPI_IN_PLACE em todos os processos. Os parâmetros sendcount, sdispls e sendtype são ignorados. Cada processo introduz dados no elemento de memória intermédia de receção correspondente.

Os dados enviados e recebidos têm de ter o mesmo tipo de mapa, conforme especificado pela matriz de recvcounts e pelo parâmetro recvtype , e são lidos a partir das localizações da memória intermédia de receção, conforme especificado pelo parâmetro rdispls .
sendcounts [in]
O número de elementos de dados que este processo envia na memória intermédia, conforme especificado no parâmetro sendbuf . Se um elemento na conta de envio for zero, a parte de dados da mensagem desse processo estará vazia.
sdispls [in]
A localização, em bytes, relativamente ao parâmetro sendbuf , dos dados para cada processo de comunicação.

A entrada j especifica a deslocação relativamente ao parâmetro sendbuf a partir do qual deve utilizar os dados de saída destinados ao processo j.
sendtypes [in]
O tipo de dados para cada um dos elementos na memória intermédia de envio. A entrada j especifica o tipo de dados que é enviado para processar j no grupo.
recvbuf [out]
O ponteiro para uma memória intermédia que contém os dados recebidos de cada processo. O número e o tipo de dados dos elementos na memória intermédia são especificados nos parâmetros recvcount e recvtype .
recvcounts [in]
O número de elementos de dados de cada processo de comunicação na memória intermédia de receção.
rdispls [in]
A localização, em bytes, relativamente ao parâmetro recvbuf , dos dados de cada processo de comunicação. A entrada i especifica a deslocação relativamente ao parâmetro recvbuf no qual os dados recebidos do processo i são colocados.

Nas matrizes de parâmetros recvbuf, recvcounts e rdispls , o nelemento de cada matriz refere-se aos dados recebidos do nth communicator process.
recvtypes [in]
O tipo de dados de cada elemento na memória intermédia. A entrada i especifica o tipo de dados recebidos do processo i.
vírgula
O MPI_Comm identificador do comunicador.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro 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

Observações

Importante

Para permitir a máxima flexibilidade, a deslocação de blocos nas memórias intermédias de envio e receção é especificada em bytes.

Todos os parâmetros são significativos em todos os processos. O parâmetro de vírgula tem de ser idêntico em todos os processos.

Se o parâmetro de comm fizer referência a um intracomunário, o bloco jque é enviado do processo i é recebido pelo processo j e é colocado no bloco ida memória intermédia de receção. Estes blocos não têm de ter todos o mesmo tamanho.

A assinatura de tipo especificada pelos parâmetros sendcounts[j] e sendtypes[j] para o processo i tem de ser igual à assinatura do tipo que está associada às contações[i] e aos recvtypes[i] no processo j. Por conseguinte, a quantidade de dados enviados tem de ser igual à quantidade de dados recebidos entre qualquer par de processos. Ainda são permitidos mapas de tipos distintos entre o remetente e o recetor.

O resultado de uma chamada para a função MPI_Alltoallw é como se cada processo enviasse uma mensagem para todos os outros processos com MPI_Send(sendbuf+sdispls[i],sendcounts[i],sendtypes[i] ,i,...)e recebesse uma mensagem de todos os outros processos com uma chamada para MPI_Recv(recvbuf+rdispls[i],recvcounts[i],recvtypes[i] ,i,...).

Especificar a opção no local indica que a mesma quantidade e tipo de dados são enviados e recebidos entre dois processos no grupo do comunicador. Diferentes pares de processos podem trocar diferentes quantidades de dados. Os utilizadores têm de garantir que as recvcounts[j] e o recvtype no processo correspondem às recvcounts[i] e ao recvtype no processo j.

Se o parâmetro de comunicação fizer referência a um intercomunicador, o resultado será como se cada processo no grupo A enviasse uma mensagem para cada processo no grupo B e vice-versa. A memóriaintermédia de envio j do processo i no grupo A deve ser consistente com a memóriaintermédia do processo j no grupo B e vice-versa.

Requisitos

Produto	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
Cabeçalho	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll