funktionen MPI_Dist_graph_neighbors

Artikel
05/24/2023

Returnerar listan över grannar som har kanter in i och ut ur anropsprocessen, samt motsvarande vikter på inkommande och utgående kanter i en distribuerad graftopologi.

Syntax

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

Parametrar

comm [in]
Handtaget för kommunikatören med den distribuerade graftopologin.
maxindegree
Storleken på matriserna för källor och källvikter (icke-negativt heltal).
sources[]
Rangordningen av processer i kommunikatören för vilka anropsprocessen är målet i den distribuerade graftopologin (matris med icke-negativa heltal).
sourceweights[]
Vikter för motsvarande kanter i anropsprocessen (matris med icke-negativa heltal).
maxoutdegree
Storleken på mål - och destweights-matriserna (icke-negativt heltal).
destinations[]
Rangordning av processer i kommunikatören som anropar processen är källan i den distribuerade graftopologin (matris med icke-negativa heltal).
destweights[]
Vikter för motsvarande kanter från anropsprocessen (matris med icke-negativa heltal).

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

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

Kommentarer

Antalet inkommande och utgående kanter och viktinformationen kan hämtas genom att anropa MPI_Dist_graph_neighbors_count innan du anropar den här metoden. Om maxindegree och maxoutdegree är mindre än antalet inkommande och utgående kanter som returneras av MPI_Dist_graph_neighbors_count returneras endast den första delen av den fullständiga listan.

Inkommande och utgående kantvikter returneras endast om diagrammet har skapats som en viktad distribuerad graf av MPI_Dist_graph_create_adjacent eller MPI_Dist_graph_create metoder och om MPI_UNWEIGHTED inte anges som ett argument i stället för källvikter eller destweights.