multi_source_dijkstra

multi_source_dijkstra(G, sources, target=None, cutoff=None, weight='weight')

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

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

参数

G网络X图表

sources非空的节点集

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

target节点标签，可选

路径的结束节点

cutoff整型或浮点型，可选

停止搜索的长度(边权重之和)。如果提供了截止点，则仅具有总权重<=截止点的返回路径。

weight字符串或函数

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

如果这是一个函数，则边的权重是函数返回的值。函数必须只接受三个位置参数：边的两个端点和该边的边属性字典。函数必须返回一个数字。

返回

distance, path一对词典，或数字与列表

如果Target为None，则返回按节点设置键的两个词典的元组。第一词典存储到源节点之一的距离。第二个存储从其中一个源到该节点的路径。如果Target不是None，则返回(Distance，Path)的元组，其中Distance是从源到目标的距离，Path是表示从源到目标的路径的列表。

加薪

ValueError

如果 sources 是空的。

NodeNotFound

如果有 sources 不在 G .

参见

multi_source_dijkstra_path

multi_source_dijkstra_path_length

笔记

边缘权重属性必须是数字。距离计算为经过加权边缘的总和。

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

基于https://code.activestate.com/recipes/119466/上的巨蟒食谱(119466)

如果边缘权重为负或为浮点数（溢出和舍入错误可能导致问题），则不保证该算法有效。

实例

>>> 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]