删除路径 (位置参考)

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

参数

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

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

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 = "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)

相关主题