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

摘要

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

使用情况

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

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

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

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

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

    • 0 - 计算并发弧段中的主要路径时未发生错误。
    • 1 - 两条或多条路径具有相同的并发弧段属性值。 将随机选择主要路径。
    • 2 - 用于计算并发弧段中的主要路径的一个或多个属性的值为 Null 或为空。
    • 3 - 用于计算并发弧段中的主要路径的一个或多个属性的值过多。
    • 4 - 并发弧段中出现以下情况之一:路径在并发弧段中未校准,或构成并发弧段的中心线未与路径几何对齐。
  • 如果选中包含几何参数,则输出数据集将为要素类。 否则,输出数据集将为表。

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

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

参数

标注说明数据类型
输入路径要素

将在其中计算路径并发的 LRS 网络要素类。

Feature Layer
输出数据集

计算结果将发布到的要素类或表。

Table
时态视图日期
(可选)

网络的时态视图日期(如果已指定)。 将此字段留空可以显示所有时间。

Date
根据优先级规则设置路径优先级。
(可选)

指定是否使用配置的路径优先级规则来设置优先级。

  • 选中 - 将使用配置的路径优先级规则来确定每个并发弧段中的主要路径。 这是默认设置。
  • 未选中 - 不会使用配置的路径优先级规则来确定每个并发弧段中的主要路径。
Boolean
包括几何
(可选)

指定输出数据集中是否包含几何。

  • 选中 - 输出数据集中将包含几何。
  • 未选中 - 结果中将不包含几何。 这是默认设置。
Boolean

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)

相关主题