fonction MPI_Dist_graph_neighbors

Article
01/16/2024

Retourne la liste des voisins ayant des arêtes entrantes et sortantes du processus appelant, ainsi que les pondérations correspondantes sur les arêtes entrantes et sortantes dans une topologie de graphe distribuée.

Syntaxe

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

Paramètres

comm [in]
Handle du communicateur avec la topologie de graphe distribuée.
maxindegree
Taille des tableaux sources et poids source (entier non négatif).
sources[]
Rangs des processus dans le communicateur pour lesquels, le processus appelant est la destination dans la topologie de graphe distribuée (tableau d’entiers non négatifs).
sourceweights[]
Pondérations des arêtes correspondantes dans le processus appelant (tableau d’entiers non négatifs).
maxoutdegree
Taille des tableaux destinations et destweights (entier non négatif).
destinations[]
Rangs des processus dans le communicateur pour lesquels le processus appelant est la source dans la topologie de graphe distribuée (tableau d’entiers non négatifs).
destweights[]
Pondérations des arêtes correspondantes en dehors du processus appelant (tableau d’entiers non négatifs).

Valeur retournée

Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.

Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .

Fortran

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

Remarques

Le nombre de bords entrants et sortants et les informations de poids peuvent être obtenus en appelant MPI_Dist_graph_neighbors_count avant d’appeler cette méthode. Si maxindegree et maxoutdegree sont inférieurs au nombre d’arêtes entrantes et sortantes retournées par MPI_Dist_graph_neighbors_count, seule la première partie de la liste complète est retournée.

Les pondérations de bord entrantes et sortantes sont retournées uniquement si le graphe a été créé en tant que graphique distribué pondéré par les méthodes MPI_Dist_graph_create_adjacent ou MPI_Dist_graph_create et si MPI_UNWEIGHTED n’est pas fourni en tant qu’argument à la place des poids source ou destweights.