функция MPI_Iallgather

2023-12-27

Собирает данные всех участников группы и отправляет их всем участникам группы неблокирующим способом.

Синтаксис

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

Параметры

sendbuf [in, необязательный]
Указатель на данные, отправляемые всем процессам в группе. Число и тип данных элементов в буфере указываются в параметрах sendcount и sendtype . Каждый элемент в буфере соответствует процессу в группе.

Если параметр comm ссылается на внутриобщий коммуникатор, можно указать параметр на месте, указав MPI_IN_PLACE во всех процессах. Параметры sendcount и sendtype игнорируются. Каждый процесс вводит данные в соответствующий элемент буфера приема. N-йпроцесс отправляет данные n-муэлементу буфера приема.
sendcount [in]
Количество элементов в буфере, указанное в параметре sendbuf . Если значение sendcount равно нулю, часть данных сообщения пуста.
sendtype [in]
Тип данных MPI элементов в буфере отправки.
recvbuf [out, optional]
Указатель на буфер, содержащий данные, полученные от каждого процесса. Число и тип данных элементов в буфере указываются в параметрах recvcount и recvtype .
recvcount [in]
Количество элементов в буфере приема. Если число равно нулю, часть данных сообщения пуста.
recvtype [in]
Тип данных MPI элементов в буфере получения.
comm [in]
Дескриптор MPI_Comm .
request [out]
Дескриптор MPI_Request , представляющий операцию взаимодействия.

Возвращаемое значение

Возвращает MPI_SUCCESS об успешном выполнении. В противном случае возвращаемое значение является кодом ошибки.

В Fortran возвращаемое значение хранится в параметре IERROR .

Fortran

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

Неблокирующий вызов инициирует коллективную операцию сокращения, которая должна быть завершена в отдельном вызове завершения. После запуска операция может выполняться независимо от любых вычислений или других взаимодействий в участвующих процессах. Таким образом, неблокирующие операции сокращения могут снизить возможные синхронные эффекты операций сокращения, выполняя их в фоновом режиме.

Все вызовы завершения (например, MPI_Wait) поддерживаются для неблокирующих операций сокращения.