multi_source_dijkstra#

multi_source_dijkstra(G, sources, target=None, cutoff=None, weight='weight')[source]#

从给定的一组源节点中找到最短加权路径和长度。

使用Dijkstra算法计算从一个源节点到给定 target 或所有其他可达节点的最短路径和长度（如果未指定），适用于加权图。

Parameters:
GNetworkX图
sources非空节点集合

路径的起始节点。如果这只是包含一个节点的集合，则此函数计算的所有路径都将从该节点开始。如果集合中有两个或更多节点，则计算的路径可能从任何一个起始节点开始。

target节点标签, 可选

路径的结束节点

cutoff整数或浮点数, 可选

搜索停止的长度（边权重的总和）。如果提供了cutoff，则仅返回总权重 <= cutoff的路径。

weight字符串或函数

如果这是一个字符串，则将通过具有此键的边属性访问边权重（即，连接 u 到 v 的边的权重将是 G.edges[u, v][weight] ）。如果不存在这样的边属性，则边的权重假定为1。

如果这是一个函数，边的权重是该函数返回的值。该函数必须接受恰好三个位置参数：一条边的两个端点和该边的属性字典。该函数必须返回一个数字或None以表示隐藏的边。

Returns:
distance, path两个字典的元组，或数字和列表

如果target为None，则返回一个由节点键控的两个字典的元组。第一个字典存储从一个源节点的距离。第二个存储从一个源节点到该节点的路径。如果target不为None，则返回一个元组(distance, path)，其中distance是从源节点到目标节点的距离，path是一个列表，表示从源节点到目标节点的路径。

Raises:
ValueError

如果 sources 为空。

NodeNotFound

如果 sources 中的任何一个不在 G 中。

See also

multi_source_dijkstra_path
multi_source_dijkstra_path_length

Notes

边权重属性必须是数值。 距离计算为遍历的加权边之和。

权重函数可以用于通过返回None来隐藏边。因此， weight = lambda u, v, d: 1 if d['color']=="red" else None 将找到最短的红色路径。

基于Python cookbook配方（119466）在 https://code.activestate.com/recipes/119466/

如果边权重为负数或浮点数，此算法不保证能工作（溢出和舍入误差可能导致问题）。

Examples

>>> G = nx.path_graph(5)
>>> length, path = nx.multi_source_dijkstra(G, {0, 4})
>>> for node in [0, 1, 2, 3, 4]:
...     print(f"{node}: {length[node]}")
0: 0
1: 1
2: 2
3: 1
4: 0
>>> path[1]
[0, 1]
>>> path[3]
[4, 3]

>>> length, path = nx.multi_source_dijkstra(G, {0, 4}, 1)
>>> length
1
>>> path
[0, 1]
On this page