驾驶距离

pgr_drivingDistance - 返回起始节点的行驶距离。

可用性

版本3.6.0

• 将输出列标准化为 (seq, depth, start_vid, pred, node, edge, cost, agg_cost)

  • pgr_drivingDistance(Single vertex)

    • 添加了 depth 和 start_vid 结果列。

  • pgr_drivingDistance(Multiple vertices)

    • 结果列名称更改： from_v``改为 ``start_vid。

    • 添加了 depth 和``pred`` 结果列。

版本2.1.0

• Signature change:

  • pgr_drivingDistance （单顶点）

• New official signature:

  • pgr_drivingDistance （多顶点）

版本2.0.0

• Official function.

描述

使用Dijkstra算法，提取所有成本小于或等于值 distance 的节点。提取的边将符合相应的生成树。

Boost Graph Inside

签名

pgr_drivingDistance(Edges SQL, Root vid, distance, [directed])

pgr_drivingDistance(Edges SQL, Root vids, distance, [options])

options: [directed, equicost]

Returns set of (seq, depth, start_vid, pred, node, edge, cost, agg_cost)

单顶点

pgr_drivingDistance(Edges SQL, Root vid, distance, [directed])

Returns set of (seq, depth, start_vid, pred, node, edge, cost, agg_cost)

示例:

从顶点 \(11\) 到 \(3.0\) 的距离

SELECT * FROM pgr_drivingDistance(
  'SELECT id, source, target, cost, reverse_cost FROM edges',
  11, 3.0);
 seq | depth | start_vid | pred | node | edge | cost | agg_cost
-----+-------+-----------+------+------+------+------+----------
   1 |     0 |        11 |   11 |   11 |   -1 |    0 |        0
   2 |     1 |        11 |   11 |    7 |    8 |    1 |        1
   3 |     1 |        11 |   11 |   12 |   11 |    1 |        1
   4 |     1 |        11 |   11 |   16 |    9 |    1 |        1
   5 |     2 |        11 |    7 |    3 |    7 |    1 |        2
   6 |     2 |        11 |    7 |    6 |    4 |    1 |        2
   7 |     2 |        11 |    7 |    8 |   10 |    1 |        2
   8 |     2 |        11 |   16 |   15 |   16 |    1 |        2
   9 |     2 |        11 |   16 |   17 |   15 |    1 |        2
  10 |     3 |        11 |    3 |    1 |    6 |    1 |        3
  11 |     3 |        11 |    6 |    5 |    1 |    1 |        3
  12 |     3 |        11 |    8 |    9 |   14 |    1 |        3
  13 |     3 |        11 |   15 |   10 |    3 |    1 |        3
(13 rows)

多顶点

pgr_drivingDistance(Edges SQL, Root vids, distance, [options])

options: [directed, equicost]

Returns set of (seq, depth, start_vid, pred, node, edge, cost, agg_cost)

示例:

从顶点 \({11, 16\}\) 出发，距离为 \(3.0\) 且有向图上的成本相等

SELECT * FROM pgr_drivingDistance(
  'SELECT id, source, target, cost, reverse_cost FROM edges',
  array[11, 16], 3.0, equicost => true);
 seq | depth | start_vid | pred | node | edge | cost | agg_cost
-----+-------+-----------+------+------+------+------+----------
   1 |     0 |        11 |   11 |   11 |   -1 |    0 |        0
   2 |     1 |        11 |   11 |    7 |    8 |    1 |        1
   3 |     1 |        11 |   11 |   12 |   11 |    1 |        1
   4 |     2 |        11 |    7 |    3 |    7 |    1 |        2
   5 |     2 |        11 |    7 |    6 |    4 |    1 |        2
   6 |     2 |        11 |    7 |    8 |   10 |    1 |        2
   7 |     3 |        11 |    3 |    1 |    6 |    1 |        3
   8 |     3 |        11 |    6 |    5 |    1 |    1 |        3
   9 |     3 |        11 |    8 |    9 |   14 |    1 |        3
  10 |     0 |        16 |   16 |   16 |   -1 |    0 |        0
  11 |     1 |        16 |   16 |   15 |   16 |    1 |        1
  12 |     1 |        16 |   16 |   17 |   15 |    1 |        1
  13 |     2 |        16 |   15 |   10 |    3 |    1 |        2
(13 rows)

参数

参数	类型	描述
Edges SQL	TEXT	Edges SQL如下所述。
Root vid	BIGINT	树的根顶点的标识符。
Root vids	ARRAY[ANY-INTEGER]	根顶点的标识符数组。 \(0\) 值被忽略 出于优化目的，任何重复的值都将被忽略。
distance	FLOAT	结果中包含节点的上限。

其中：

ANY-NUMERIC:

SMALLINT, INTEGER, BIGINT, REAL, FLOAT

可选参数

列	类型	默认	描述
directed	BOOLEAN	true	当 true 时，该图被视为有 有向 如果为 false ，则该图被视为 无向。

行驶距离可选参数

列	类型	默认	描述
equicost	BOOLEAN	true	true``时，节点只会出现在最近的 ``start_vid 列表中。绑定制动是任意的。 false 时，类似于使用单顶点签名的多次调用。

内部查询

Edges SQL

列	类型	默认	描述
id	ANY-INTEGER		边的标识符。
source	ANY-INTEGER		边的第一个端点顶点的标识符。
target	ANY-INTEGER		边的第二个端点顶点的标识符。
cost	ANY-NUMERICAL		边(source, target)的权重
reverse_cost	ANY-NUMERICAL	-1	边(target, source)的权重 当为负时：边（ target, source ）不存在，因此它不是图的一部分。

其中：

ANY-INTEGER:

SMALLINT, INTEGER, BIGINT

ANY-NUMERICAL:

SMALLINT, INTEGER, BIGINT, REAL, FLOAT

结果列

Returns set of (seq, depth, start_vid, pred, node, edge, cost, agg_cost)

参数	类型	描述
seq	BIGINT	从 \(1\) 开始的顺序值。
depth	BIGINT	node 的深度。 \(0\) 当 node = start_vid。 \(depth-1\) is the depth of pred
start_vid	BIGINT	根顶点的标识符。
pred	BIGINT	node 的前驱。 当 node 等于 start_vid 时，它的值就是 node。
node	BIGINT	使用 edge 到达的``node`` 的标识符。
edge	BIGINT	从 pred 到达``node``所使用的 edge 的标识符。 \(-1\) 当 node = start_vid。
cost	FLOAT	遍历 edge 的成本。
agg_cost	FLOAT	从 start_vid 到 node 的总成本。

其他示例

示例:

在无向图上，从顶点 \({11, 16\}\) 开始的距离为 \(3.0\)

SELECT * FROM pgr_drivingDistance(
  'SELECT id, source, target, cost, reverse_cost FROM edges',
  array[11, 16], 3.0, directed => false);
 seq | depth | start_vid | pred | node | edge | cost | agg_cost
-----+-------+-----------+------+------+------+------+----------
   1 |     0 |        11 |   11 |   11 |   -1 |    0 |        0
   2 |     1 |        11 |   11 |    7 |    8 |    1 |        1
   3 |     1 |        11 |   11 |   10 |    5 |    1 |        1
   4 |     1 |        11 |   11 |   12 |   11 |    1 |        1
   5 |     1 |        11 |   11 |   16 |    9 |    1 |        1
   6 |     2 |        11 |    7 |    3 |    7 |    1 |        2
   7 |     2 |        11 |   10 |    6 |    2 |    1 |        2
   8 |     2 |        11 |    7 |    8 |   10 |    1 |        2
   9 |     2 |        11 |   10 |   15 |    3 |    1 |        2
  10 |     2 |        11 |   16 |   17 |   15 |    1 |        2
  11 |     3 |        11 |    3 |    1 |    6 |    1 |        3
  12 |     3 |        11 |    6 |    5 |    1 |    1 |        3
  13 |     3 |        11 |    8 |    9 |   14 |    1 |        3
  14 |     0 |        16 |   16 |   16 |   -1 |    0 |        0
  15 |     1 |        16 |   16 |   11 |    9 |    1 |        1
  16 |     1 |        16 |   16 |   15 |   16 |    1 |        1
  17 |     1 |        16 |   16 |   17 |   15 |    1 |        1
  18 |     2 |        16 |   11 |    7 |    8 |    1 |        2
  19 |     2 |        16 |   11 |   10 |    5 |    1 |        2
  20 |     2 |        16 |   17 |   12 |   13 |    1 |        2
  21 |     3 |        16 |    7 |    3 |    7 |    1 |        3
  22 |     3 |        16 |    7 |    6 |    4 |    1 |        3
  23 |     3 |        16 |    7 |    8 |   10 |    1 |        3
(23 rows)

另请参阅

• pgr_alphaShape - Alpha 形状计算

• 示例数据

索引和表格

• Index

• Search Page