MPI_Dist_graph_neighbors函式

發行項
01/16/2024

傳回具有邊緣進入和離開呼叫進程的鄰近清單，以及分散式圖形拓撲中傳入和傳出邊緣的對應權數。

語法

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

參數

comm [in]
通訊器的句柄與分散式圖形拓撲。
maxindegree
來源和sourceweights數位的大小 (非負整數) 。
sources[]
通訊器中的進程排名，呼叫進程是分散式圖形拓撲中的目的地， (非負整數陣列) 。
sourceweights[]
對應邊緣的加權至呼叫進程 (非負整數陣列) 。
maxoutdegree
目的地和 destweights 陣列的大小 (非負整數) 。
destinations[]
呼叫進程是分散式圖形拓撲中來源的通訊器中的進程排名， (非負整數陣列) 。
destweights[]
呼叫進程外對應邊緣的加權， (非負整數陣列) 。

傳回值

傳回成功 時MPI_SUCCESS 。否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

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

備註

呼叫此方法之前，可以呼叫 MPI_Dist_graph_neighbors_count 來取得傳入和傳出邊緣計數和權數資訊。如果 maxindegree 和 maxoutdegree 小於 MPI_Dist_graph_neighbors_count傳回的傳入和傳出邊緣數目，則只會傳回完整清單的第一個部分。

只有在圖形是由 MPI_Dist_graph_create_adjacent 或 MPI_Dist_graph_create 方法建立為加權分散式圖形時，才會傳回傳入和傳出邊緣權數，而且如果 MPI_UNWEIGHTED 未以自變數的形式提供，則不會以 sourceweights 或 destweights的形式提供。