Функции работы с коммуникаторами

В данном подразделе рассматриваются функции работы с коммуникаторами. Они разделяются на функции доступа к коммуникаторам и функции создания коммуникаторов. Функции доступа являются локальными и не требуют коммуникаций, в отличие от функций создания, которые являются коллективными и могут потребовать межпроцессорных коммуникаций. Две основных функции доступа к коммуникатору, MPI_Comm_size - опрос числа процессов в области связи и MPI_Comm_rank - опрос идентификатора (номера) процесса в области связи, были рассмотрены в самом начале среди базовых функций MPI (раздел 2). Кроме них, имеется функция сравнения двух коммуникаторов MPI_Comm_compare.

С:

MPI_Comm_compare(MPI_Comm comm1,MPI_Comm comm2, int *result)

FORTRAN:

MPI_COMM_COMPARE(COMM1, COMM2, RESULT, IERROR)

INTEGER COMM1, COMM2, RESULT, IERROR

IN	comm1	- первый коммуникатор;
IN	comm2	- второй коммуникатор;
OUT	result	- результат сравнения.

Возможные значения результата сравнения:

MPI_IDENT	-	коммуникаторы идентичны, представляют один и тот же объект;
MPI_CONGRUENT	-	коммуникаторы конгруэнтны, две области связи с одними и теми же атрибутами группы;
MPI_SIMILAR	-	коммуникаторы подобны, группы содержат одни и те же процессы, но другое упорядочивание;
MPI_UNEQUAL	-	во всех других случаях.

Создание нового коммуникатора возможно с помощью одной из трех функций: MPI_Comm_dup, MPI_Comm_create, MPI_Comm_split.

Функция дублирования коммуникатора MPI_Comm_dup.

С:

MPI_Comm_dup(MPI_Comm comm, MPI_Comm *newcomm)

FORTRAN:

MPI_COMM_DUP(COMM, NEWCOMM, IERROR)

INTEGER COMM, NEWCOMM, IERROR

IN	comm	- коммуникатор;
OUT	newcomm	- копия коммуникатора.

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

Функция создания коммуникатора MPI_Comm_create.

С:

MPI_Comm_create(MPI_Comm comm, MPI_Group group,

MPI_Comm *newcomm)

FORTRAN:

MPI_COMM_CREATE(COMM, GROUP, NEWCOMM, IERROR)

INTEGER COMM, GROUP, NEWCOMM, IERROR

IN	comm	-	родительский коммуникатор;
IN	group	-	группа, для которой создается коммуникатор;
OUT	newcomm	-	новый коммуникатор.

Эта функция создает коммуникатор для группы group. Для процессов, которые не являются членами группы, возвращается значение MPI_COMM_NULL. Функция возвращает код ошибки, если группа group не является подгруппой родительского коммуникатора.

Функция расщепления коммуникатора MPI_Comm_split.

С:

MPI_Comm_split(MPI_Comm comm, int color, int key,

MPI_Comm *newcomm)

FORTRAN:

MPI_COMM_SPLIT(COMM, COLOR, KEY, NEWCOMM, IERROR)

INTEGER COMM, COLOR, KEY, NEWCOMM, IERROR

IN	comm	-	родительский коммуникатор;
IN	color	-	признак подгруппы;
IN	key	-	управление упорядочиванием;
OUT	newcomm	-	новый коммуникатор.

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

Приведем алгоритм расщепления группы из восьми процессов на три подгруппы и его графическую интерпретацию (Рис.18).

MPI_comm comm, newcomm;int myid, color;......MPI_Comm_rank(comm, &myid);color = myid%3;MPI_Comm_split(comm, color, myid, &newcomm);

 

В данном примере первую подгруппу образовали процессы, номера которых делятся на 3 без остатка, вторую - для которых остаток равен 1 и третью - для которых остаток равен 2. Отметим, что после выполнения функции MPI_Comm_split значения коммуникатора newcomm в процессах разных подгрупп будут отличаться.

Функция уничтожения коммуникатораа MPI_Comm_free.

С:

MPI_Comm_free(MPI_Comm *comm)

FORTRAN:

MPI_COMM_FREE(COMM, IERROR)

INTEGER COMM, IERROR

IN comm - уничтожаемый коммуникатор.

Примечание: За рамками данного руководства мы оставим обсуждение inter коммуникаторов и вопросы, связанные с изменением или добавлением новых атрибутов коммуникаторов.