функция MPI_Scatterv

2023-05-24

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

Синтаксис

int MPIAPI MPI_Scatterv(
  _In_  void         *sendbuf,
  _In_  int          *sendcounts,
  _In_  int          *displs,
        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 — размер группы; Сегмент, соответствующий корневому процессу, не перемещается.
sendcounts [in]
Количество элементов, отправляемых в каждый процесс. Если sendcount[i] равно нулю, то часть данных сообщения для этого процесса пуста.

Параметр sendcount игнорируется для всех некорневых процессов.
displs [in]
Расположения данных, отправляемых в каждый процесс коммуникатора. Каждое расположение в массиве относительно соответствующего элемента массива sendbuf .

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

Этот параметр имеет значение только в корневом процессе.
sendtype
Тип данных MPI для каждого элемента в буфере.

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

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

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

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

Fortran

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

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

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

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

Если параметр comm ссылается на интеркоммуникатор, то вызов включает все процессы в интеркоммуникаторе, но с одной группой, группой A, которая определяет корневой процесс. Все процессы в другой группе, группе B, задают одно и то же значение в корневом параметре, то есть ранг корневого процесса в группе A. Корневой процесс задает значение , MPI_ROOT в параметре root . Все остальные процессы в группе A задают значение , MPI_PROC_NULL в корневом параметре. Данные передаются из корневого процесса во все процессы в группе 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