MPI_Dist_graph_neighbors funkce

Článek
01/16/2024

Vrátí seznam sousedů, kteří mají hrany do a ven z procesu volání, a také odpovídající váhy na příchozích a odchozích hranách v distribuované topologii grafu.

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

Parametry

comm [in]
Popisovač komunikátoru s distribuovanou topologií grafů.
maxindegree
Velikost polí sourcea sourceweights (nezáporné celé číslo)
zdroje[]
Pořadí procesů v komunikátoru, pro které je volající proces cílem v distribuované topologii grafu (pole nezáporných celých čísel).
sourceweights[]
Váhy odpovídajících hran do procesu volání (pole nezáporných celých čísel).
maxoutdegree
Velikost polí cílů a destweights (nezáporné celé číslo)
destinations[]
Pořadí procesů v komunikátoru, pro které je volající proces zdrojem v distribuované topologii grafu (pole nezáporných celých čísel).
destweights[]
Váhy odpovídajících hran z procesu volání (pole nezáporných celých čísel)

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

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

Poznámky

Počet příchozích a odchozích okrajů a informace o hmotnosti lze získat voláním MPI_Dist_graph_neighbors_count před voláním této metody. Pokud jsou hodnoty maxindegree a maxoutdegree menší než počet příchozích a odchozích hran vrácených MPI_Dist_graph_neighbors_count, vrátí se pouze první část úplného seznamu.

Váhy příchozích a odchozích okrajů jsou vráceny pouze v případě, že byl graf vytvořen jako vážený distribuovaný graf MPI_Dist_graph_create_adjacent nebo metodami MPI_Dist_graph_create a pokud MPI_UNWEIGHTED není zadán jako argument místo zdrojových vah nebo destvaží.