funzione MPI_Dist_graph_neighbors

Articolo
01/16/2024

Restituisce l'elenco dei vicini con bordi verso e fuori dal processo chiamante, nonché i pesi corrispondenti sui bordi in ingresso e in uscita in una topologia a grafo distribuito.

Sintassi

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

Parametri

comm [in]
Handle del comunicatore con la topologia del grafo distribuito.
maxindegree
Dimensioni delle matrici di origini e pesi di origine (integer non negativo).
sources[]
Classifica i processi nel comunicatore per cui, il processo chiamante è la destinazione nella topologia del grafo distribuito (matrice di interi non negativi).
pesi di origine[]
Pesi dei bordi corrispondenti nel processo chiamante (matrice di interi non negativi).
maxoutdegree
Dimensioni delle destinazioni e delle matrici destweights (integer non negativo).
destinazioni[]
Classifica i processi nel comunicatore per cui il processo chiamante è l'origine nella topologia del grafo distribuito (matrice di interi non negativi).
destweights[]
Pesi dei bordi corrispondenti dal processo chiamante (matrice di interi non negativi).

Valore restituito

Restituisce MPI_SUCCESS in caso di esito positivo. In caso contrario, il valore restituito è un codice di errore.

In Fortran il valore restituito viene archiviato nel parametro IERROR .

Fortran

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

Commenti

Il conteggio dei bordi in ingresso e in uscita e le informazioni sul peso possono essere ottenute chiamando MPI_Dist_graph_neighbors_count prima di chiamare questo metodo. Se maxindegree e maxoutdegree sono inferiori al numero di bordi in ingresso e in uscita restituiti da MPI_Dist_graph_neighbors_count, viene restituita solo la prima parte dell'elenco completo.

I pesi dei bordi in ingresso e in uscita vengono restituiti solo se il grafico è stato creato come grafico distribuito ponderato dal MPI_Dist_graph_create_adjacent o dai metodi di MPI_Dist_graph_create e se MPI_UNWEIGHTED non viene fornito come argomento al posto dei pesi di origine o dei pesi dest.