функция MPI_Iscatterv

2024-01-16

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

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

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

Fortran

    MPI_ISCATTERV(SENDBUF, SENDCOUNTS, DISPLS, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNTS(*), DISPLS(*), SENDTYPE, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR

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

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