функция MPI_Dist_graph_neighbors

2024-01-16

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

Синтаксис

int WINAPI MPI_Dist_graph_neighbors(
  _In_ MPI_Comm              comm,
       _In_range_(>=,0)  int maxindegree,
       _Out_writes_opt int   sources[],
       _Out_writes_opt int   sourceweights[],
       _In_range_(>=,0)  int maxoutdegree,
       _Out_writes_opt int   destinations[],
       _Out_writes_opt int   destweights[]
);

Параметры

comm [in]
Дескриптор связи с топологией распределенного графа.
maxindegree
Размер массивов источников и исходных весов (неотрицательное целое число).
sources[]
Ранжирует процессы в коммуникаторе, для которых вызывающий процесс является назначением в топологии распределенного графа (массив неотрицательных целых чисел).
sourceweights[]
Вес соответствующих ребер в вызывающем процессе (массив неотрицательных целых чисел).
maxoutdegree
Размер массивов назначений и destweights (неотрицательное целое число).
destinations[]
Ранжирует процессы в коммуникаторе, для которых вызывающий процесс является источником в топологии распределенного графа (массив неотрицательных целых чисел).
destweights[]
Вес соответствующих ребер из вызывающего процесса (массив неотрицательных целых чисел).

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

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

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

Fortran

    MPI_DIST_GRAPH_NEIGHBORS (COMM, MAXINDEGREE, SOURCES, SOURCEWEIGHTS,
    MAXOUTDEGREE, DESTINATIONS, DESTWEIGHTS, IERROR)
        INTEGER COMM, MAXINDEGREE, SOURCES (*), SOURCEWEIGHTS (*), MAXOUTDEGREE,
    DESTINATIONS (*), DESTWEIGHTS (*), IERROR

Количество входящих и исходящих ребер и сведения о весе можно получить, вызвав MPI_Dist_graph_neighbors_count перед вызовом этого метода. Если значения maxindegree и maxoutdegree меньше числа входящих и исходящих ребер, возвращаемых MPI_Dist_graph_neighbors_count, возвращается только первая часть полного списка.

Весы входящего и исходящего ребер возвращаются только в том случае, если граф был создан в качестве взвешеного распределенного графа методом MPI_Dist_graph_create_adjacent или MPI_Dist_graph_create и если MPI_UNWEIGHTED не предоставляется в качестве аргумента вместо исходных весов или destweights.