функция MPI_Igatherv

2024-01-16

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

Синтаксис

int MPIAPI MPI_Igatherv(
  _In_opt_  const void         *sendbuf,
  _In_            int          sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_opt_  const int          recvcounts[],
  _In_opt_  const int          displs[],
  _In_            MPI_Datatype recvtype,
  _In_            int          root,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

Параметры

sendbuf [in, необязательный]
Дескриптор буфера, содержащего данные для отправки в корневой процесс.

Если параметр comm ссылается на внутриобщий коммуникатор, можно указать параметр на месте, указав MPI_IN_PLACE во всех процессах. Параметры sendcount и sendtype игнорируются. Каждый процесс вводит данные в соответствующий элемент буфера приема. N-йпроцесс отправляет данные n-муэлементу буфера приема. Предполагается, что данные, отправляемые корневым процессом, должны находиться в правильном месте в буфере приема.
sendcount [in]
Количество элементов в буфере отправки. Если значение sendcount равно нулю, часть данных сообщения пуста.
sendtype [in]
Тип данных каждого элемента в буфере.
recvbuf [out, optional]
Дескриптор буфера корневого процесса, который содержит данные, полученные от каждого процесса, включая данные, отправляемые корневым процессом. Этот параметр имеет значение только в корневом процессе. Параметр recvbuf игнорируется для всех некорневых процессов.
recvcounts[] [in, необязательный]
Количество элементов, полученных от каждого процесса. Каждый элемент в массиве соответствует рангу процесса отправки. Если число равно нулю, часть данных сообщения пуста. Этот параметр имеет значение только в корневом процессе.
displs[] [in, optional]
Расположение данных из каждого процесса коммуникатора относительно параметра recvbuf . Данные, полученные из процесса j , помещаются в буфер получения элементов displs[j] корневого смещения процесса из указателя sendbuf .

В массивах параметров recvbuf, recvcounts и displsn-йэлемент каждого массива ссылается на данные, полученные из процесса n-гокоммуникатора.

Этот параметр имеет значение только в корневом процессе.
recvtype [in]
Тип данных каждого элемента в буфере. Этот параметр имеет значение только в корневом процессе.
root [in]
Ранг принимающего процесса в указанном коммуникаторе.
comm [in]
Дескриптор MPI_Comm .
request [out]
Дескриптор MPI_Request , представляющий операцию взаимодействия.

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

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

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

Fortran

    MPI_IGATHERV(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNTS, DISPLS, RECVTYPE,
    ROOT, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNTS(*), DISPLS(*), RECVTYPE, ROOT, COMM, REQUEST, IERROR

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

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