使用已配置和启用的 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 (可选) | 指定是否更新网络中的所有事件要素类。
| Boolean |
event_layers [event_layers,...] (可选) | 将更新 DerivedRouteID 和测量字段的事件图层。 | Feature Layer |
| 名称 | 说明 | 数据类型 |
| out_events | 更新的事件要素图层。 | Feature Layer |
| out_details_file | 详细说明对事件要素图层所做更改的文本文件。 注：此工具的验证结果将写入 ArcGIS Server 目录。 默认情况下，此文件会在 10 分钟内自动清除，这可能不足以处理所有验证并将其写入正在运行 ArcGIS Pro 的工作站。 对于较大的数据负载，建议您将文件最长保留期限调整为至少一小时。 | Text File |
以下 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 in Python window.
# Requires: ArcGIS Location Referencing
# Set current workspace
arcpy.env.workspace = r"C:\Data\PipelineReferencing.gdb"
# Local variables
in_route_features = "LineNetwork"
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"
# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)以下独立 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 in stand-alone script.
# 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')以下独立 Python 脚本演示了如何在要素服务中使用 DeriveEventMeasures 函数。
# Name: DeriveEventMeasures_ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# 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_route_features = 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_route_features, update_all_events, event_layers)
# Check in license
arcpy.CheckInExtension('LocationReferencing')