MPI_Dist_graph_neighbors függvény

Visszaadja azoknak a szomszédoknak a listáját, amelyek élekkel rendelkeznek a hívási folyamaton belül és kívül, valamint a bejövő és kimenő élek megfelelő súlyait egy elosztott gráftopológiában.

Szintaxis

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éterek

• comm [in]
  A kommunikátor leírója az elosztott gráftopológiával.

• maxindegree
  A források és a forrássúly tömbök mérete (nem negatív egész szám).

• források[]
  A kommunikátorban lévő folyamatok rangsora, amelyeknél a hívási folyamat az elosztott gráf topológiájának célhelye (nem negatív egész számok tömbje).

• sourceweights[]
  A megfelelő élek súlya a hívási folyamatba (nem negatív egész számok tömbje).

• maxoutdegree
  A cél- és súlyzótömbök mérete (nem negatív egész szám).

• célhelyek[]
  A kommunikátor azon folyamatainak sorrendje, amelyeknél a hívási folyamat az elosztott gráf topológiájának forrása (nem negatív egész számok tömbje).

• destweights[]
  A megfelelő élek súlyozása a hívási folyamatból (nem negatív egész számok tömbje).

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben lesz tárolva.

Fortran

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

Megjegyzések

A bejövő és kimenő élek száma, valamint a súlyadatok a metódus meghívása előtt MPI_Dist_graph_neighbors_count hívásával kérhetők le. Ha a maxindegree és a maxoutdegree kisebb, mint a MPI_Dist_graph_neighbors_count által visszaadott bejövő és kimenő élek száma, akkor a rendszer csak a teljes lista első részét adja vissza.

A bejövő és kimenő élvastagságok csak akkor lesznek visszaadva, ha a gráf súlyozott elosztott gráfként lett létrehozva a MPI_Dist_graph_create_adjacent vagy a MPI_Dist_graph_create metódusok által, és ha a MPI_UNWEIGHTED nem a forrássúlyok vagy a destweights helyett argumentumként van megadva.

Követelmények

Termék	Microsoft MPI v6
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI folyamattopológiafüggvények

MPI_Dist_graph_create

MPI_Dist_graph_neighbors_count

MPI_Dist_graph_create_adjacent