scipy.sparse.csgraph.

breadth_first_order#

scipy.sparse.csgraph.breadth_first_order(csgraph, i_start, directed=True, return_predecessors=True)#

返回从指定节点开始的广度优先排序。

请注意,广度优先顺序不是唯一的,但它生成的树是唯一的。

在版本 0.11.0 中添加。

参数:
csgraph类数组或稀疏数组或矩阵

N x N 压缩稀疏图。输入 csgraph 将转换为 csr 格式进行计算。

i_startint

起始节点的索引。

directedbool,可选

如果为 True(默认),则在有向图上操作:仅沿路径 csgraph[i, j] 从点 i 移动到点 j。 如果为 False,则在无向图上查找最短路径:算法可以沿 csgraph[i, j] 或 csgraph[j, i] 从点 i 前进到 j。

return_predecessorsbool,可选

如果为 True(默认),则返回前驱数组(见下文)。

返回:
node_arrayndarray,一维

从指定节点开始的节点的广度优先列表。 node_array 的长度是从指定节点可到达的节点数。

predecessorsndarray,一维

仅当 return_predecessors 为 True 时返回。长度为 N 的列表中,包含广度优先树中每个节点的前驱节点。 如果节点 i 在树中,则其父节点由 predecessors[i] 给出。 如果节点 i 不在树中(对于父节点),则 predecessors[i] = -9999。

备注

如果存在多个有效的解决方案,则输出可能因 SciPy 和 Python 版本而异。

示例

>>> from scipy.sparse import csr_array
>>> from scipy.sparse.csgraph import breadth_first_order
>>> graph = [
... [0, 1, 2, 0],
... [0, 0, 0, 1],
... [2, 0, 0, 3],
... [0, 0, 0, 0]
... ]
>>> graph = csr_array(graph)
>>> print(graph)
<Compressed Sparse Row sparse array of dtype 'int64'
    with 5 stored elements and shape (4, 4)>
    Coords  Values
    (0, 1)  1
    (0, 2)  2
    (1, 3)  1
    (2, 0)  2
    (2, 3)  3
>>> breadth_first_order(graph,0)
(array([0, 1, 2, 3], dtype=int32), array([-9999,     0,     0,     1], dtype=int32))