返回顶部

删除路径 (位置参考)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

适用于 Location Referencing 许可。

摘要

从 LRS 网络中删除路径和相关数据元素。

使用情况

  • 运行此工具需要 LRS 数据集。

    了解有关在 ArcGIS Pipeline Referencing 中创建 LRS 数据集或在 ArcGIS Roads and Highways 中创建 LRS 数据集的详细信息。

  • 在删除路径时，您还可以使用删除路径工具执行以下操作：

    • 删除所有具有已删除路径 routeId 的“中心线序列”记录。
    • 删除 lrs_edit_log 表中与已删除路径相关的所有记录。
    • 可以选择删除关联的中心线、校准点和事件。
      警告：

      在不使用删除关联中心线、删除关联校准点和删除关联事件参数的情况下，运行删除路径可能会导致这些中心线、校准点和事件不参考任何路径。

  • 输入必须是在 LRS 网络中注册的网络要素类。

  • 在运行工具之前选择需要删除的路径。 可以使用选择工具或定义查询对 LRS 网络要素类进行选择。

  • 如果未在 LRS 网络要素类中选择任何路径，则该工具将运行失败。

  • 选择的具有相同 routeId 的路径记录将随时间被删除。

  • 如果在线网络中选择了一条路径，则同一线中的所有路径都将随时间被删除。

  • 如果选中删除关联校准点参数，则与路径关联的校准点将随时间被删除。

  • 如果选中删除关联事件参数，则所有在网络上注册的具有与已删除路径相同的 routeId 的事件将随时间被删除。

  • 如果选中删除关联中心线参数，则将删除与所选路径关联的中心线。 如果在网络之间共享中心线，则不会删除这些公共中心线。

  • 建议不要在数据库的默认版本上运行此工具。

  • 如果此工具在编辑会话中运行，则可以撤消已删除的路径。

    • 警告：

    如果此工具在编辑会话外运行，则无法撤消已删除的路径。

  • 对于具有空 routeId 或 lineId 的路径，该工具将运行但不会删除记录。

  • 启用时间过滤器时，无法在 ArcGIS Pro 的网络图层上运行删除路径工具。

  • 此工具支持冲突预防，并将尝试获取和转移锁。

    了解有关 ArcGIS Pipeline Referencing 中的冲突预防或 ArcGIS Roads and Highways 中的冲突预防的详细信息。

参数

对话框Python

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

在网络中注册的路径要素类。

Feature Layer
删除关联的校准点
(可选)

指定是否删除与已删除路径关联的校准点。

  • 选中 - 将删除与路径关联的校准点。
  • 未选中 - 不会删除与路径关联的校准点。 这是默认设置。
Boolean
删除关联的事件
(可选)

指定是否删除与已删除路径关联的事件。

  • 选中 - 将删除与路径关联的事件。
  • 未选中 - 不会删除与路径关联的事件。 这是默认设置。
Boolean
删除关联的中心线
(可选)

指定是否将删除仅与已删除路径关联的中心线。

  • 选中 - 将删除仅与所选路径关联的中心线。 如果在网络之间共享中心线，则不会删除这些公共中心线。
  • 未选中 - 不会删除中心线。 这是默认设置。
Boolean

派生输出

标注说明数据类型
更新的路径要素

更新的 LRS 网络要素类

Feature Layer
输出结果文件

详细说明对从 LRS 网络要素类中删除的路径的文本文件。

Text File
输出派生路径要素

更新的派生路径要素图层。

Feature Layer

arcpy.locref.DeleteRoutes(in_route_features, {delete_associated_calibration_points}, {delete_associated_events}, {delete_associated_centerlines})
名称说明数据类型
in_route_features

在网络中注册的路径要素类。

Feature Layer
delete_associated_calibration_points
(可选)

指定是否删除与已删除路径关联的校准点。

  • DELETE_CALIBRATION_POINTS—将删除与路径关联的校准点。
  • NO_DELETE_CALIBRATION_POINTS—不会删除与路径关联的校准点。 这是默认设置。
Boolean
delete_associated_events
(可选)

指定是否删除与已删除路径关联的事件。

  • DELETE_EVENTS—将删除与路径关联的事件。
  • NO_DELETE_EVENTS—不会删除与路径关联的事件。 这是默认设置。
Boolean
delete_associated_centerlines
(可选)

指定是否将删除仅与已删除路径关联的中心线。

  • DELETE_CENTERLINES—将删除仅与所选路径关联的中心线。 如果在网络之间共享中心线，则不会删除这些公共中心线。
  • NO_DELETE_CENTERLINES—不会删除中心线。 这是默认设置。
Boolean

派生输出

名称说明数据类型
updated_route_features

更新的 LRS 网络要素类

Feature Layer
out_details_file

详细说明对从 LRS 网络要素类中删除的路径的文本文件。

Text File
out_derived_route_features

更新的派生路径要素图层。

Feature Layer

代码示例

DeleteRoutes 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 DeleteRoutes 函数。

# Name: DeleteRoutes_ex1.py
# Description: Delete routes and associated data elements from an LRS Network in the Python window
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace = r"C:\Data\UPDM.gdb"

# Delete Routes tool variables
in_route_features = "PipelineNetwork"
delete_associated_calibration_points = "DELETE_CALIBRATION_POINTS" 
delete_associated_events = "DELETE_EVENTS"
delete_associated_centerlines = "DELETE_CENTERLINES"

# Execute Delete Routes. (Input route features must be selected prior to tool execution)
arcpy.locref.DeleteRoutes(in_route_features, delete_associated_calibration_points, delete_associated_events, delete_associated_centerlines)
DeleteRoutes 示例 2（独立脚本）

以下独立脚本演示了如何使用 DeleteRoutes 函数。

# Name: DeleteRoutes_ex2.py
# Description: Delete routes and associated data elements from an LRS Network.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Provide the path of database
arcpy.env.workspace = r"C:\Users\Desktop\PipelineReferencing.gdb\LRS\LineNetwork"

# Convert network feature class to layer
arcpy.management.MakeFeatureLayer("LineNetwork", "networklyr")

# Process: Select Layer By Attribute
arcpy.management.SelectLayerByAttribute("networklyr", "NEW_SELECTION", "RouteID = '11316262800'")

# Run Delete Routes tool
arcpy.locref.DeleteRoutes("networklyr", "DELETE_CALIBRATION_POINTS", "DELETE_EVENTS", "DELETE_CENTERLINES")

print("Successfully deleted the selected route...")

# Check in license
arcpy.CheckInExtension('LocationReferencing')
DeleteRoutes 示例 3（独立脚本）

以下独立脚本演示了如何在要素服务中使用 DeleteRoutes 函数。

# Name: DeleteRoutes_Pro_Ex3.py
# Description: Delete routes in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set tool variables
delete_associated_calibration_points = "DELETE_CALIBRATION_POINTS"
delete_associated_events = "DELETE_EVENTS"
delete_associated_centerlines = "DELETE_CENTERLINES"

# Input LRS route network is in a feature service. Sign into portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Make a layer of the LRS route network from the feature service for applying selection. Here, 1 corresponds to the LRS route network
in_route_layer = arcpy.management.MakeFeatureLayer("https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1", 'route_layer')

## Process: Select Layer by attribute as required
arcpy.management.SelectLayerByAttribute(in_route_layer, "NEW_SELECTION", "RouteID = 'routeid1'")

# Process : Delete Routes
arcpy.locref.DeleteRoutes( in_route_layer, delete_associated_calibration_points, delete_associated_events, delete_associated_centerlines)

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

环境

当前工作空间

许可信息

  • 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）

相关主题

  • 位置参考工具箱概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息