função MPI_Iallgather

Artigo
12/27/2023

Recolhe dados de todos os membros de um grupo e envia os dados a todos os membros do grupo de forma não bloqueada.

Sintaxe

int MPIAPI MPI_Iallgather(
  _In_opt_  const void         *sendbuf,
  _In_             int         sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

Parâmetros

sendbuf [em, opcional]
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 e sendtype são ignorados. Cada processo introduz dados no elemento de memória intermédia de receção correspondente. O nth process envia dados para o elemento nda memória intermédia de receção.
sendcount [in]
O número de elementos na memória intermédia que é especificado no parâmetro sendbuf . Se a conta de envio for zero, a parte de dados da mensagem estará vazia.
sendtype [in]
O tipo de dados MPI dos elementos na memória intermédia de envio.
recvbuf [fora, opcional]
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 .
recvcount [in]
O número de elementos na memória intermédia de receção. Se a contagem for zero, a parte de dados da mensagem estará vazia.
recvtype [in]
O tipo de dados MPI dos elementos na memória intermédia de receção.
vírgula [em]
O MPI_Comm identificador do comunicador.
pedido [fora]
O MPI_Request identificador que representa a operação de comunicação.

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_IALLGATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR

Observações

Uma chamada sem bloqueio inicia uma operação de redução coletiva que tem de ser concluída numa chamada de conclusão separada. Uma vez iniciada, a operação pode progredir independentemente de qualquer computação ou outra comunicação nos processos participantes. Desta forma, as operações de redução não bloqueadas podem mitigar possíveis efeitos de sincronização das operações de redução ao executá-las em "segundo plano".

Todas as chamadas de conclusão (por exemplo, MPI_Wait) são suportadas para operações de redução sem bloqueio.