计算路径并发 (位置参考)

摘要

计算和报告 LRS 网络中的并发路径弧段。

使用情况

• 仅在路径共享相同的中心线时，才会发现重叠的路径弧段。 此工具无法识别使用不同中心线的拓扑重叠路径。

• 网络中的每个并发弧段均具有唯一的弧段 ID GUID，这意味着并发弧段中的所有路径都将具有一条包含相同弧段 ID 的记录。

• DominantFlag 字段包含两个潜在值。

  • 0 - 并发弧段中的子路径
  • 1 - 并发弧段中的主要路径

• DominantError 字段包含以下潜在值：

  • 0 - 计算并发弧段中的主要路径时未发生错误。
  • 1 - 两条或多条路径具有相同的并发弧段属性值。 将随机选择主要路径。
  • 2 - 用于计算并发弧段中的主要路径的一个或多个属性的值为 Null 或为空。
  • 3 - 用于计算并发弧段中的主要路径的一个或多个属性的值过多。
  • 4 - 并发弧段中出现以下情况之一：路径在并发弧段中未校准，或构成并发弧段的中心线未与路径几何对齐。

• 如果选中包含几何参数，则输出数据集将为要素类。 否则，输出数据集将为表。

• 指定时态视图日期参数值来计算该时间点的并发。 将此字段留空可以显示所有时间的并发。

• 在运行此工具之前，建议您使用配置路径优先级规则工具为 LRS 网络配置路径优先级规则。

参数

对话框

标注	说明	数据类型
输入路径要素	将在其中计算路径并发的 LRS 网络要素类。	Feature Layer
输出数据集	计算结果将发布到的要素类或表。	Table
时态视图日期 (可选)	网络的时态视图日期（如果已指定）。 将此字段留空可以显示所有时间。	Date
根据优先级规则设置路径优先级。 (可选)	指定是否使用配置的路径优先级规则来设置优先级。 选中 - 将使用配置的路径优先级规则来确定每个并发弧段中的主要路径。 这是默认设置。 未选中 - 不会使用配置的路径优先级规则来确定每个并发弧段中的主要路径。	Boolean
包括几何 (可选)	指定输出数据集中是否包含几何。 选中 - 输出数据集中将包含几何。 未选中 - 结果中将不包含几何。 这是默认设置。	Boolean

Python

arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, {tvd}, {find_dominance}, {include_geometry})

名称	说明	数据类型
in_route_features	将在其中计算路径并发的 LRS 网络要素类。	Feature Layer
out_dataset	计算结果将发布到的要素类或表。	Table
tvd (可选)	网络的时态视图日期（如果已指定）。 将此字段留空可以显示所有时间。	Date
find_dominance (可选)	指定是否使用配置的路径优先级规则来设置优先级。 FIND_DOMINANCE—将使用配置的路径优先级规则来确定每个并发弧段中的主要路径。 这是默认设置。 NO_FIND_DOMINANCE—不会使用配置的路径优先级规则来确定每个并发弧段中的主要路径。	Boolean
include_geometry (可选)	指定输出数据集中是否包含几何。 EXCLUDE_GEOMETRY—结果中将不包含几何。 这是默认设置。 INCLUDE_GEOMETRY—输出数据集中将包含几何。	Boolean

代码示例

CalculateRouteConcurrencies 示例 1（独立脚本）

演示了如何将 CalculateRouteConcurrencies 函数用作独立脚本。

# Name: CalculateRouteConcurrencies_Pro_ex1.py
# Description: Calculates and reports concurrent route sections in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_route_features = r"C:\Data\SampleData.gdb\LRS\NonlineNetwork"
out_dataset = r"C:\Data\SampleData.gdb\LRS\ConcurrentRoutes"
tvd = ""
find_dominance = "FIND_DOMINANCE"
include_geometry = "INCLUDE_GEOMETRY"

# Execute the tool
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, tvd, find_dominance, include_geometry)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')

CalculateRouteConcurrencies 示例 2（Python 窗口）

演示了如何在 Python 窗口中使用 CalculateRouteConcurrencies 函数。

# Name: CalculateRouteConcurrencies_Pro_ex2.py
# Description: Calculates and reports concurrent route sections in an LRS Network in the Python window.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_route_features = r"C:\Data\SampleData.gdb\LRS\NonlineNetwork"
out_dataset = r"C:\Data\SampleData.gdb\LRS\ConcurrentRoutes"
tvd = "06/09/2021"
find_dominance = "NO_FIND_DOMINANCE"
include_geometry = "EXCLUDE_GEOMETRY"

# Execute the tool
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, tvd, find_dominance, include_geometry)

环境

当前工作空间, 临时工作空间

许可信息

• Basic: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
• Standard: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
• Advanced: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）