функция MPI_Scatter

2023-12-27

Распределяет данные из одного члена по всем членам группы. Функция MPI_Scatter выполняет обратную операцию, выполняемую функцией MPI_Gather .

Синтаксис

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

Параметры

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

Параметр sendbuf игнорируется для всех некорневых процессов.

Если параметр comm ссылается на внутриобщий коммуникатор, можно указать параметр на месте, указав MPI_IN_PLACE в корневом процессе. Параметры recvcount и recvtype игнорируются. Точечный вектор по-прежнему считается содержащим n сегментов, где n — размер группы; Сегмент, соответствующий корневому процессу, не перемещается.
sendcount
Количество элементов в буфере отправки. Если значение sendcount равно нулю, часть данных сообщения пуста.

Параметр sendcount игнорируется для всех некорневых процессов.
sendtype
Тип данных каждого элемента в буфере.

Параметр sendcount игнорируется для всех некорневых процессов.
recvbuf [out]
Дескриптор буфера, содержащего данные, полученные в каждом процессе. Число и тип данных элементов в буфере указываются в параметрах recvcount и recvtype .
recvcount
Количество элементов в буфере приема. Если число равно нулю, часть данных сообщения пуста.
recvtype
Тип данных элементов в буфере приема.
root
Ранг процесса отправки в указанном коммуникаторе.
Comm
Дескриптор MPI_Comm .

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

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

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

Fortran

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

Функция MPI_Scatter действует так, как если бы корневой процесс отправлял сообщение с помощью функции MPI_Send . Это сообщение делится на n равных сегментов, по одному для каждого члена группы. I-йсегмент отправляется в i-йпроцесс в группе.

Если comm является внутриобщим, результат будет таким же, как если бы корень выполнил n операций MPI_Send(sendbuf + i*sendcount*extent(sendtype), sendcount, sendtype, I, …)отправки ; и каждый процесс выполнял получение, MPI_Recv(recvbuf, recvcount, recvtype, i,…).

Сигнатура типа, указанная параметрами sendcount и sendtype для корневого процесса, должна быть равна сигнатуре типа, заданной в recvcount, и параметрам recvtype для всех процессов. Таким образом, объем отправляемых данных должен быть равен объему данных, получаемых между любой парой процессов. Отдельные сопоставления типов между отправителем и получателем по-прежнему разрешены.

Все параметры функции важны для корневого процесса. В других процессах важны только параметры recvbuf, recvcount, recvtype, root и comm . Параметры root и comm должны быть одинаковыми во всех процессах.

Спецификация счетчиков и типов не должна приводить к тому, что любое расположение в корневом каталоге будет прочитано несколько раз.

Если параметр comm ссылается на интеркоммуникатор, то вызов включает все процессы в интеркоммуникаторе, но с одной группой, группой A, которая определяет корневой процесс. Все процессы в другой группе, группе B, задают одно и то же значение в корневом параметре, то есть ранг корневого процесса в группе A. Корневой процесс задает значение MPI_ROOT в параметре root . Все остальные процессы в группе A задают значение MPI_PROC_NULL в параметре root . Данные передаются из корневого процесса всем процессам в группе B. Параметры буфера процессов в группе B должны соответствовать параметру buffer корневого процесса.

Требования

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