Função MPI_Dist_graph_neighbors

Artigo
01/16/2024

Retorna a lista de vizinhos que têm bordas dentro e fora do processo de chamada, bem como os pesos correspondentes nas bordas de entrada e saída em uma topologia de grafo distribuído.

Sintaxe

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]
O identificador do comunicador com a topologia de grafo distribuído.
maxindegree
Tamanho das matrizes sources e sourceweights (inteiro não negativo).
sources[]
Classificações de processos no comunicador para o qual o processo de chamada é o destino na topologia de grafo distribuído (matriz de inteiros não negativos).
sourceweights[]
Pesos das bordas correspondentes no processo de chamada (matriz de inteiros não negativos).
maxoutdegree
Tamanho das matrizes de destinos e pesos médios (inteiro não negativo).
destinations[]
Classificações de processos no comunicador para o qual o processo de chamada é a origem na topologia de grafo distribuído (matriz de inteiros não negativos).
destweights[]
Pesos das bordas correspondentes fora do processo de chamada (matriz de inteiros não negativos).

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

Em Fortran, o valor retornado é armazenado no 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

Comentários

A contagem de bordas de entrada e saída e as informações de peso podem ser obtidas chamando MPI_Dist_graph_neighbors_count antes de chamar esse método. Se maxindegree e maxoutdegree forem menores que o número de bordas de entrada e saída retornadas por MPI_Dist_graph_neighbors_count, somente a primeira parte da lista completa será retornada.

Os pesos de borda de entrada e saída serão retornados somente se o grafo tiver sido criado como um grafo distribuído ponderado pelo MPI_Dist_graph_create_adjacent ou pelos métodos MPI_Dist_graph_create e se MPI_UNWEIGHTED não for fornecido como um argumento no lugar de pesos-fonte ou pesos-fonte.