fungsi MPI_Dist_graph_neighbors

Artikel
05/24/2023

Mengembalikan daftar tetangga yang memiliki tepi ke dalam dan ke luar proses panggilan, serta bobot yang sesuai pada tepi masuk dan keluar dalam topologi grafik terdistribusi.

Sintaks

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]
Handel communicator dengan topologi grafik terdistribusi.
maxindegree
Ukuran array sumber dan sourceweights (bilangan bulat non-negatif).
sources[]
Peringkat proses dalam komunikator yang, proses panggilan adalah tujuan dalam topologi grafik terdistribusi (array bilangan bulat non-negatif).
sourceweights[]
Bobot tepi yang sesuai ke dalam proses panggilan (array bilangan bulat non-negatif).
maxoutdegree
Ukuran destinasi dan array destweights (bilangan bulat non-negatif).
destinations[]
Peringkat proses dalam communicator yang proses panggilannya adalah sumber dalam topologi grafik terdistribusi (array bilangan bulat non-negatif).
destweights[]
Bobot tepi yang sesuai dari proses panggilan (array bilangan bulat non-negatif).

Menampilkan nilai

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai pengembalian disimpan dalam parameter IERROR .

Fortran

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

Keterangan

Jumlah tepi masuk dan keluar dan informasi bobot dapat diperoleh dengan memanggil MPI_Dist_graph_neighbors_count sebelum memanggil metode ini. Jika maxindegree dan maxoutdegree kurang dari jumlah tepi masuk dan keluar yang dikembalikan oleh MPI_Dist_graph_neighbors_count, maka hanya bagian pertama dari daftar lengkap yang dikembalikan.

Bobot tepi masuk dan keluar dikembalikan hanya jika grafik dibuat sebagai grafik terdistribusi tertimbang oleh metode MPI_Dist_graph_create_adjacent atau MPI_Dist_graph_create dan jika MPI_UNWEIGHTED tidak disediakan sebagai argumen sebagai pengganti sourceweight atau destweight.