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