функция MPI_Allgather

2023-12-27

Собирает данные всех участников группы и отправляет их всем членам группы. Функция MPI_Allgather аналогична функции MPI_Gather , за исключением того, что она отправляет данные во все процессы, а не только в корень. Правила использования для MPI_Allgather соответствуют правилам для MPI_Gather.

Синтаксис

int MPIAPI MPI_Allgather(
  _In_  void         *sendbuf,
  _In_  int          sendcount,
  _In_  MPI_Datatype sendtype,
  _Out_ void         *recvbuf,
        int          recvcount,
        MPI_Datatype recvtype,
        MPI_Comm     comm
);

Параметры

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

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

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

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

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

Fortran

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

Если параметр comm ссылается на внутриобщий объект связи, результат вызова MPI_ALLGATHER(...) будет таким же, как если бы все процессы выполняли n вызовов MPI_Gather(sendbuf,sendcount,sendtype,recvbuf,recvcount,recvtype,root,comm) для root = 0 , ..., n-1.

Если параметр comm ссылается на интеркоммуникатор, то каждый процесс одной группы, например группы A, определяет количество элементов данных, указанных в параметре sendcount . Эти данные объединяются, и результат сохраняется в каждом процессе в другой группе, группе Б. И наоборот, объединение данных процессов в группе B сохраняется в каждом процессе в группе A. Параметры буфера отправки в группе A должны быть согласованы с параметрами буфера приема в группе B и наоборот.

Количество элементов, отправляемых процессами в группе A, не равно количеству элементов, отправленных процессами в группе B. В частности, можно перемещать данные только в одном направлении, указав sendcount == 0 для обмена данными в обратном направлении.

Требования

Продукт	Распространяемый пакет HPC 2012 MS-MPI, пакет HPC 2008 R2 распространяемый пакет MS-MPI, пакет HPC 2008 MS-MPI или клиентские служебные программы пакета HPC 2008
Заголовок	Mpi.h; Mpif.h
Библиотека	Msmpi.lib
DLL	Msmpi.dll

См. также раздел

Коллективные функции MPI

MPI_Datatype

MPI_Allgather

Поделиться через