MPI_Dist_graph_neighbors-Funktion

Artikel
01/16/2024

Gibt die Liste der Nachbarn mit Kanten in und aus dem aufrufenden Prozess sowie die entsprechenden Gewichtungen an den ein- und ausgehenden Kanten in einer verteilten Graphtopologie zurück.

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

Parameter

comm [in]
Das Handle des Communicators mit der verteilten Graphtopologie.
maxindegree
Größe der Quellen - und Quellgewichtsarrays (nicht negative ganze Zahl).
Quellen[]
Rangfolgen von Prozessen im Communicator, für die der aufrufende Prozess das Ziel in der verteilten Graphtopologie (Array von nicht negativen ganzen Zahlen) ist.
sourceweights[]
Gewichtung der entsprechenden Kanten in den aufrufenden Prozess (Array von nicht negativen ganzen Zahlen).
maxoutdegree
Größe der Ziel- und Destgewichtungsarrays (nicht negative ganze Zahl).
Destinationen[]
Rangfolgen von Prozessen im Communicator, für die der aufrufende Prozess die Quelle in der verteilten Graphtopologie ist (Array von nicht negativen ganzen Zahlen).
destweights[]
Gewichtung der entsprechenden Kanten aus dem aufrufenden Prozess (Array von nicht negativen ganzen Zahlen).

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

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

Hinweise

Die Anzahl der eingehenden und ausgehenden Kanten und die Gewichtungsinformationen können durch Aufrufen MPI_Dist_graph_neighbors_count vor dem Aufrufen dieser Methode abgerufen werden. Wenn maxoutdegree und maxoutdegree kleiner als die Anzahl der von MPI_Dist_graph_neighbors_count zurückgegebenen ein- und ausgehenden Kanten sind, wird nur der erste Teil der vollständigen Liste zurückgegeben.

Die ein- und ausgehende Kantengewichtung wird nur zurückgegeben, wenn das Diagramm als gewichtetes verteiltes Diagramm von der MPI_Dist_graph_create_adjacent - oder MPI_Dist_graph_create-Methode erstellt wurde und MPI_UNWEIGHTED nicht als Argument anstelle von Sourceweights oder Destweights angegeben wird.