删除路径 (位置参考工具)

汇总

从 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 中的冲突预防的详细信息。

标注	说明	数据类型
输入路径要素	在网络中注册的路径要素类。	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"

# Run 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

# 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...")

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

# 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)

环境

当前工作空间

许可信息

基本: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
标准: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
高级: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）

删除路径 (位置参考工具)

汇总

用法

注意：

注意：

参数

派生输出

环境

许可信息

相关主题