 |
|
MPI_ Group_incl(group, n, ranks, newgroup)
IN groupгруппа (дескриптор)
IN nколичество элементов в массиве номеров (и размер newgroup, целое)
IN ranksномера процессов в group, перешедших в новую группу (массив целых)
OUT newgroupновая группа, полученная из прежней, упорядоченная согласно ranks
Cоздает новую группу, которая состоит из nпроцессов исходной группы groupс номерами rank[0],..., rank[n-1];процесс с номером iв newgroupесть процесс с номером ranks[i]в group. Если n = 0, то newgroupимеет значение MPI_GROUP_EMPTY.
MPI_Group _excl(group, n, ranks, newgroup)
IN groupгруппа (дескриптор)
IN nколичество элементов в массиве номеров (целое)
IN ranksмассив целочисленных номеров в group, не входящих в newgroup
OUT newgroupновая группа, полученная из прежней, сохраняющая порядок, определенный group (дескриптор)
Создает новую группу, путем удаления из groupпроцессов с номерами ranks[0] ,...ranks[n-1].Если n = 0, то newgroupидентична group.
Деструктор групп - MPI_Group _free(group)
INOUT groupидентификатор группы (дескриптор)
Функции доступа к коммуникаторам
Все следующие операции являются локальными.
MPI_Comm_size (comm, size)
IN commкоммуникатор (дескриптор)
OUT sizeколичество процессов в группе comm (целое)
Эта функция указывает число процессов в коммуникаторе. Для MPI_COMM_WORLDона указывает общее количество доступных процессов.
MPI_Comm_rank(comm, rank)
IN commкоммуникатор (дескриптор)
OUT rankномер вызывающего процесса в группе comm (целое)
Функция MPI_Comm_rank возвращает номер процесса в частной группе коммуникатора. Ее удобно использовать cовместно сMPI_Comm_size.
MPI_Comm_compare(comm1, comm2, result)
IN comm1первый коммуникатор (дескриптор)
IN comm2второй коммуникатор (дескриптор)
OUT resultрезультат (целое)
Функция MPI_Comm_compare сравнивает контексты коммуникаторов. Результат MPI_IDENTимеет местотогда и только тогда, когда comm1и comm2являются дескрипторами для одного и того же объекта. Результат MPI_CONGRUENT имеет местов том случае, еслиисходные группы идентичны по компонентам и нумерации; в этом случае коммуникаторы отличаются только контекстом. Результат MPI_SIMILARимеет место, если члены группы обоих коммуникаторов являются одинаковыми, но порядок их нумерации различен. В противном случае выдается результат MPI_UNEQUAL.
Конструкторы коммуникаторов
Ниже перечисленные функции являются коллективными и вызываются всеми процессами в группе, связанной с comm. В MPI для создания нового коммуникатора необходим исходный коммуникатор. Основным коммуникатором для всех MPI коммуникаторов является коммуникатор MPI_COMM_WORLD.
MPI_Comm_dup(comm, newcomm)
IN commкоммуникатор (дескриптор)
OUT newcommкопия comm (дескриптор)
Функция MPI_Comm_dup дублирует существующий коммуникатор comm,возвращает в аргументе newcommновый коммуникатор с той же группой.