функция MPI_Group_range_excl

Создает новую группу путем удаления процессов из существующей группы.

Синтаксис

int MPIAPI MPI_Group_range_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int ranges[][3],
  _Out_ MPI_Group         *newgroup
);

Параметры

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

• n
  Количество диапазонов процессов, исключаемых из новой группы.

• Диапазоны
  Массив спецификаций процессов, исключаемых из существующей группы. Каждый элемент массива задает диапазон процесса в виде трех целых чисел для первого ранга, последнего ранга и шага.

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

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

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

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

Fortran

    MPI_GROUP_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Комментарии

Каждый вычисляемый ранг должен быть допустимым в существующей группе, а все вычисляемые ранги должны быть отдельными; В противном случае функция возвращает ошибку.

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

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

Требования

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

MPI_Comm_group