функция MPI_Group_incl

Создает новую группу, содержащую подмножество процессов в существующей группе.

Синтаксис

int MPIAPI MPI_Group_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Параметры

• group
  Существующая группа.

• n
  Количество элементов в параметре рангов и размер новой группы.

• Ряды
  Процессы, которые будут включены в новую группу.

• newgroup [out]
  Указатель на дескриптор, представляющий новую группу, которая содержит включенные процессы в том порядке, в котором они указаны в параметре рангов .

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

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

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

Fortran

    MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Комментарии

Эту функцию можно использовать для изменения порядка элементов группы.

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

Реализация MPI не предоставляет механизм для создания группы с нуля, а только из существующих групп. Базовую группу, в которой определены все остальные группы, можно получить с помощью функции MPI_Comm_group . Это группа, связанная с начальным MPI_COMM_WORLD коммуникатора.

Требования

Продукт	Распространяемый пакет HHPC 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_Comm_group