função MPI_Dist_graph_neighbors

Artigo
01/16/2024

Devolve a lista de vizinhos com arestas dentro e fora do processo de chamada, bem como os pesos correspondentes nas margens de entrada e saída numa topologia distribuída de grafos.

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

vírgula [em]
A alça do comunicador com a topologia de grafo distribuído.
maxindegree
Tamanho das matrizes de origens e pesos-fonte (número inteiro não negativo).
origens[]
Classificações de processos no comunicador para o qual o processo de chamada é o destino na topologia de grafos distribuídos (matriz de números inteiros não negativos).
pesos-fonte[]
Pesos das arestas correspondentes no processo de chamada (matriz de números inteiros não negativos).
maxoutdegree
Tamanho das matrizes de destinos e de pesos-pesados (número inteiro não negativo).
destinations[]
Classificações de processos no comunicador para o qual o processo de chamada é a origem na topologia de grafos distribuídos (matriz de números inteiros não negativos).
destweights[]
Pesos das arestas correspondentes fora do processo de chamada (matriz de números inteiros não negativos).

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é 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

Observações

A contagem de extremidades de entrada e saída e as informações de ponderação podem ser obtidas ao chamar MPI_Dist_graph_neighbors_count antes de chamar este método. Se maxindegree e maxoutdegree forem inferiores ao número de arestas de entrada e saída devolvidas por MPI_Dist_graph_neighbors_count, só é devolvida a primeira parte da lista completa.

Os pesos de extremidade de entrada e saída só são devolvidos se o gráfico tiver sido criado como um gráfico distribuído ponderado pelo MPI_Dist_graph_create_adjacent ou pelos métodos de MPI_Dist_graph_create e se MPI_UNWEIGHTED não for fornecido como um argumento em vez de pesos-fonte ou pesos-pesados.