MPI_Dist_graph_neighbors función

Artículo
01/16/2024

Devuelve la lista de vecinos que tienen bordes dentro y fuera del proceso de llamada, así como los pesos correspondientes en los bordes entrantes y salientes de una topología de grafo distribuido.

Sintaxis

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

Parámetros

comm [in]
Identificador del comunicador con la topología de grafo distribuido.
maxindegree
Tamaño de lasmatrices de orígenes y pesos de origen (entero no negativo).
sources[]
Rangos de procesos en el comunicador para el que, el proceso de llamada es el destino en la topología de grafo distribuido (matriz de enteros no negativos).
sourceweights[]
Pesos de los bordes correspondientes en el proceso de llamada (matriz de enteros no negativos).
maxoutdegree
Tamaño de las matrices de destinos y destweights (entero no negativo).
destinos[]
Rangos de procesos en el comunicador para el que el proceso de llamada es el origen de la topología de grafo distribuido (matriz de enteros no negativos).
destweights[]
Pesos de los bordes correspondientes fuera del proceso de llamada (matriz de enteros no negativos).

Valor devuelto

Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.

En Fortran, el valor devuelto se almacena en el parámetro IERROR .

Fortran

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

Comentarios

El recuento de bordes entrantes y salientes y la información de peso se pueden obtener llamando a MPI_Dist_graph_neighbors_count antes de llamar a este método. Si maxindegree y maxoutdegree son menores que el número de bordes entrantes y salientes devueltos por MPI_Dist_graph_neighbors_count, solo se devuelve la primera parte de la lista completa.

Los pesos perimetrales entrantes y salientes solo se devuelven si el gráfico se creó como un gráfico distribuido ponderado por el MPI_Dist_graph_create_adjacent o los métodos MPI_Dist_graph_create y si MPI_UNWEIGHTED no se proporciona como argumento en lugar de pesos de origen o destweights.