shortest_path#

shortest_path(G, source=None, target=None, weight=None, method='dijkstra')[source]#

计算图中的最短路径。

Parameters:
GNetworkX 图
source节点, 可选

路径的起始节点。如果未指定,则计算每个可能起始节点的最短路径。

target节点, 可选

路径的终止节点。如果未指定,则计算到所有可能节点的最短路径。

weightNone, 字符串或函数, 可选 (默认 = None)

如果为 None,则每条边的权重/距离/成本为 1。 如果是字符串,则使用此边属性作为边权重。 任何未指定的边属性默认值为 1。 如果是函数,则边的权重是该函数返回的值。该函数必须接受三个位置参数:边的两个端点和该边的边属性字典。 该函数必须返回一个数字。

method字符串, 可选 (默认 = ‘dijkstra’)

用于计算路径的算法。 支持的选项:’dijkstra’, ‘bellman-ford’。 其他输入会产生 ValueError。 如果 weight 为 None,则使用无权图方法,此建议被忽略。

Returns:
path: 列表或字典

所有返回的路径都包含路径中的源和目标。

如果同时指定了源和目标,则返回从源到目标的最短路径中的节点列表。

如果仅指定了源,则返回以目标为键的字典,其中包含从源到其中一个目标的最短路径中的节点列表。

如果仅指定了目标,则返回以源为键的字典,其中包含从其中一个源到目标的最短路径中的节点列表。

如果既未指定源也未指定目标,则返回字典的字典,其中 path[source][target]=[路径中的节点列表]。

Raises:
NodeNotFound

如果 source 不在 G 中。

ValueError

如果 method 不在支持的选项中。

See also

all_pairs_shortest_path
all_pairs_dijkstra_path
all_pairs_bellman_ford_path
single_source_shortest_path
single_source_dijkstra_path
single_source_bellman_ford_path

Notes

在源和目标之间可能存在多个最短路径。 此函数仅返回其中一条。

Examples

>>> G = nx.path_graph(5)
>>> print(nx.shortest_path(G, source=0, target=4))
[0, 1, 2, 3, 4]
>>> p = nx.shortest_path(G, source=0)  # 未指定目标
>>> p[3]  # 从源=0到目标=3的最短路径
[0, 1, 2, 3]
>>> p = nx.shortest_path(G, target=4)  # 未指定源
>>> p[1]  # 从源=1到目标=4的最短路径
[1, 2, 3, 4]
>>> p = dict(nx.shortest_path(G))  # 未指定源和目标
>>> p[2][4]  # 从源=2到目标=4的最短路径
[2, 3, 4]