派生事件测量 (位置参考)

摘要

使用已配置和启用DerivedRouteID 字段填充和更新点和线事件上的这些字段和测量值。

使用情况

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

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

  • 该工具旨在作为更大型的工作流的一部分运行。 在运行派生事件测量之前运行应用事件行为生成路径工具。 在未运行工作流中先前工具的情况下运行此工具,可能会导致数据不准确。

  • 建议您在数据初始迁移时在文件地理数据库上运行此工具。 这样运行速度更快,因为操作必须修改数据库中的所有事件记录。 在生产中,该工具可以在已修改的路径选择集上运行,从而大幅减少处理时间。

  • 输入事件要素图层必须配置 DerivedRouteID 和测量字段。

  • 该工具可以在线网络中的一个、多个或所有事件上运行。

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

  • 启用冲突预防后,支持以下内容:

    • 派生事件测量需要更新的事件将自动获取事件锁(如果可用)。 如果无法获取锁,该工具将失败并提供这些锁的文本文件。

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

    • 在默认版本中工作时,获取的锁会在工具完成后自动释放。
    • 在子版本中工作时,获取的锁将在工具完成后保持为发布状态。 用户必须发布或删除该版本才能释放锁。
    • 在子版本中工作时,如果中断取消工具运行,则获取的锁将保持在可释放状态。

参数

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

LRS 网络包含配置了 DerivedRouteID 和测量字段的事件。

Feature Layer
更新所选网络中注册的所有事件要素类
(可选)

指定是否更新网络中的所有事件要素类。

  • 选中 - 将更新在输入路径要素参数值中选择的网络中的所有事件要素类。 这是默认设置。
  • 未选中 - 不会更新在输入路径要素参数值中选择的网络中的所有事件要素类。 可以使用事件图层参数选择单个事件图层。
Boolean
事件图层
(可选)

将更新 DerivedRouteID 和测量字段的事件图层。

Feature Layer

派生输出

标注说明数据类型
输出事件

更新的事件要素图层。

Feature Layer
输出详细信息文件

详细说明对事件要素图层所做更改的文本文件。

注:

此工具的验证结果将写入 ArcGIS Server 目录。 默认情况下,此文件会在 10 分钟内自动清除,这可能不足以处理所有验证并将其写入正在运行 ArcGIS Pro 的工作站。 对于较大的数据负载,建议您将文件最长保留期限调整为至少一小时。

Text File

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})
名称说明数据类型
in_route_features

LRS 网络包含配置了 DerivedRouteID 和测量字段的事件。

Feature Layer
update_all_events
(可选)

指定是否更新网络中的所有事件要素类。

  • UPDATE_ALL将更新在 in_route_features 参数值中选择的网络中的所有事件要素类。 这是默认设置。
  • UPDATE_SOME不会更新在 in_route_features 参数值中选择的网络中的所有事件要素类。 可以使用 event_layers 参数选择单个事件图层。
Boolean
event_layers
[event_layers,...]
(可选)

将更新 DerivedRouteID 和测量字段的事件图层。

Feature Layer

派生输出

名称说明数据类型
out_events

更新的事件要素图层。

Feature Layer
out_details_file

详细说明对事件要素图层所做更改的文本文件。

注:

此工具的验证结果将写入 ArcGIS Server 目录。 默认情况下,此文件会在 10 分钟内自动清除,这可能不足以处理所有验证并将其写入正在运行 ArcGIS Pro 的工作站。 对于较大的数据负载,建议您将文件最长保留期限调整为至少一小时。

Text File

代码示例

DeriveEventMeasures 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 DeriveEventMeasures

# Name: DeriveEventMeasures_ex1.py
# Description: Populate and update the Derived RouteID and measure values on point and line events with those fields configured and enabled.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

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

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)
DeriveEventMeasures 示例 2(独立脚本)

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

# Name: DeriveEventMeasures_ex2.py
# Description: Populate and update the Derived routeID and measure values on point and line events with those fields configured and enabled.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_ALL"
event_layers = ""

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

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

# Name: DeriveEventMeasures_Pro_Ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

## Input LRS Route Network is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the input route network from the feature service. Here, 3 corresponds to the input route network.
in_lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Set tool variables.
update_all_events = "UPDATE_ALL"
event_layers = ""

# Process : Derive Event Measures.
arcpy.locref.DeriveEventMeasures(in_lrs_network, update_all_events, event_layers)

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

相关主题