funkcja MPI_Dist_graph_neighbors

Artykuł
01/16/2024

Zwraca listę sąsiadów mających krawędzie do i z procesu wywoływania, a także odpowiednie wagi na krawędziach przychodzących i wychodzących w topologii grafu rozproszonego.

Składnia

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[]
);

Parametry

comm [in]
Uchwyt komunikatora z rozproszoną topologią grafu.
maxindegree
Rozmiar tablic źródeł i liczb źródłowych (liczba całkowita nieujemna).
sources[]
Szeregi procesów w komunikatorze, dla którego proces wywołujący jest miejscem docelowym w topologii grafu rozproszonego (tablica nieujemnych liczb całkowitych).
sourceweights[]
Wagi odpowiednich krawędzi do procesu wywołującego (tablica nieujemnych liczb całkowitych).
maxoutdegree
Rozmiar miejsc docelowych i tablic destweights (nieujemna liczba całkowita).
miejsca docelowe[]
Szeregi procesów w komunikatorze, dla którego proces wywołujący jest źródłem w topologii grafu rozproszonego (tablica nieujemnych liczb całkowitych).
destweights[]
Wagi odpowiednich krawędzi poza procesem wywołującym (tablica nieujemnych liczb całkowitych).

Wartość zwracana

Zwraca MPI_SUCCESS powodzenia. W przeciwnym razie wartość zwracana jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

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

Uwagi

Liczba przychodzących i wychodzących krawędzi oraz informacje o wadze można uzyskać, wywołując MPI_Dist_graph_neighbors_count przed wywołaniem tej metody. Jeśli maxindegree i maxoutdegree są mniejsze niż liczba krawędzi przychodzących i wychodzących zwracanych przez MPI_Dist_graph_neighbors_count, zwracana jest tylko pierwsza część pełnej listy.

Wagi krawędzi przychodzących i wychodzących są zwracane tylko wtedy, gdy graf został utworzony jako wykres rozproszony ważony przez MPI_Dist_graph_create_adjacent lub metody MPI_Dist_graph_create, a jeśli MPI_UNWEIGHTED nie jest podany jako argument zamiast wagi źródłowej lub wagi.