функция MPI_Bcast

2023-12-27

Транслирует данные от одного участника группы всем участникам группы.

Синтаксис

int MPIAPI MPI_Bcast(
  _Inout_  void        *buffer,
  _In_    int          count,
  _In_    MPI_Datatype datatype,
  _In_    int          root,
  _In_    MPI_Comm     comm
);

Параметры

buffer [in, out]
Указатель на буфер данных. В процессе, заданном параметром root , буфер содержит данные для трансляции. Во всех остальных процессах в коммуникаторе, заданном параметром comm , буфер получает данные, передаваемые корневым процессом.
count [in]
Количество элементов данных в буфере. Если параметр count равен нулю, часть данных сообщения пуста.
datatype [in]
Тип данных MPI элементов в буфере отправки.
root [in]
Ранг процесса, отправляющего данные.
comm [in]
Дескриптор MPI_Comm .

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

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

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

Fortran

    MPI_BCAST(BUFFER, COUNT, DATATYPE, ROOT, COMM, IERROR)
        <type> BUFFER(*)  
        INTEGER COUNT, DATATYPE, ROOT, COMM, IERROR

Подпись типа в соответствии с параметрами count и datatype для каждого процесса должна быть равна сигнатуре типа в корне. Это требование подразумевает, что объем отправленных данных должен быть равен объему полученных данных в парном диапазоне между каждым процессом и корнем. MPI_Bcast и все другие коллективные процедуры перемещения данных делают это ограничение. Отдельные сопоставления типов между отправителем и получателем по-прежнему разрешены.

Если параметр comm ссылается на внутриобщий коммуникатор, функция MPI_Bcast передает сообщение из указанного процесса всем процессам группы, включающей себя. Он вызывается всеми членами группы, использующими одни и те же параметры. При возврате содержимое корневого буфера копируется во все остальные процессы.

Если параметр 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

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

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

MPI_Datatype

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