修改 LRS 事件 (位置参考)

摘要

修改线性参考系统 (LRS) 事件的属性。

使用情况

• 修改的字段应包含在 ArcGIS Pipeline Referencing 事件数据模型或 ArcGIS Roads and Highways 事件数据模型中概述的属性。

• 可以使用此工具在事件中添加或移除以下属性：

  连续网络的当前事件

  事件类型	支持路径名称	支持跨越路径
  线	否	N/A
  线	是	N/A
  点	否	N/A
  点	是	N/A

  连续网络的修改事件

  事件类型	支持路径名称	支持跨越路径
  线	是	N/A
  线	否	N/A
  点	是	N/A
  点	否	N/A

  工程网络的当前事件

  事件类型	支持路径名称	支持跨越路径
  线	否	否
  线	是	否
  线	是	否
  线	是	是
  点	否	N/A
  点	是	N/A

  工程网络的修改事件

  事件类型	支持路径名称	支持跨越路径
  线	是	否
  线	否	否
  线	是	是
  线	是	否
  点	是	N/A
  点	否	N/A

参数

对话框

标注	说明	数据类型
LRS 事件要素类	事件的输入要素类或要素图层。	Feature Layer
事件 ID 字段	事件 ID 字段的名称。	Field
路径 ID 字段	路径 ID 字段的名称。	Field
开始日期字段	开始日期字段的名称。	Field
结束日期字段	结束日期字段的名称。	Field
位置错误字段	位置错误字段的名称。	Field
测量字段	如果是点事件，则为测量字段的名称；如果是线事件，则为测量始于字段。	Field
测量止于字段 (可选)	测量止于字段的名称。 此为线事件的必需项。	Field
事件跨越路径 (可选)	保留原样—未更改属性。 这是默认设置。 不跨越路径—事件记录不会跨越路径。 仅适用于线事件。 跨越路径—事件记录可能跨越路径。 仅适用于线事件。	String
路径止于 ID 字段 (可选)	路径止于 ID 字段的名称。 仅当其为线事件并且跨越路径时，此内容才为必需项。	Field
存储路径名称 (可选)	保留原样—未更改属性。 这是默认设置。 不存储路径名称—路径名称不会与事件记录一起存储。 存储路径名称—路径名称将与事件记录一起存储。	String
路径名称字段 (可选)	如果为不跨越路径的点事件，则为路径名称字段；如果为跨越路径的线事件，则为路径始于名称字段。 如果启用了存储路径名称，则此内容为必需项。	Field
路径止于名称字段 (可选)	路径止于名称字段的名称。 如果其为线事件，已选择保存路径名称，并且跨越路径，则此内容为必需项。	Field

派生输出

标注	说明	数据类型
更新的 LRS 事件要素类	更新的事件要素图层。	Feature Layer

Python

arcpy.locref.ModifyLRSEvent(in_feature_class, event_id_field, route_id_field, from_date_field, to_date_field, loc_error_field, measure_field, {to_measure_field}, {event_spans_routes}, {to_route_id_field}, {store_route_name}, {route_name_field}, {to_route_name_field})

名称	说明	数据类型
in_feature_class	事件的输入要素类或要素图层。	Feature Layer
event_id_field	事件 ID 字段的名称。	Field
route_id_field	路径 ID 字段的名称。	Field
from_date_field	开始日期字段的名称。	Field
to_date_field	结束日期字段的名称。	Field
loc_error_field	位置错误字段的名称。	Field
measure_field	如果是点事件，则为测量字段的名称；如果是线事件，则为测量始于字段。	Field
to_measure_field (可选)	测量止于字段的名称。 此为线事件的必需项。	Field
event_spans_routes (可选)	指定事件记录是否跨越路径。 AS_IS—未更改属性。 这是默认设置。 NO_SPANS_ROUTES—事件记录不会跨越路径。 仅适用于线事件。 SPANS_ROUTES—事件记录可能跨越路径。 仅适用于线事件。	String
to_route_id_field (可选)	路径止于 ID 字段的名称。 仅当其为线事件并且跨越路径时，此内容才为必需项。	Field
store_route_name (可选)	指定事件记录是否将存储路径名称。 AS_IS—未更改属性。 这是默认设置。 STORE_ROUTE_NAME—路径名称将与事件记录一起存储。 NO_STORE_ROUTE_NAME—路径名称不会与事件记录一起存储。	String
route_name_field (可选)	如果为不跨越路径的点事件，则为路径名称字段；如果为跨越路径的线事件，则为路径始于名称字段。 如果已设置 STORE_ROUTE_NAME，则此内容为必需项。	Field
to_route_name_field (可选)	路径止于名称字段的名称。 如果为线事件且已设置 store_route_name 和 SPANS_ROUTES，则此内容为必需项。	Field

派生输出

名称	说明	数据类型
out_feature_class	更新的事件要素图层。	Feature Layer

代码示例

ModifyLRSEvent 示例 1（Python 窗口）

以下脚本演示了如何在 Python 窗口中使用 ModifyLRSEvent 工具，以使事件跨越路径。

# Name: Modify_LRS_Event_ex1.py
# Description: Modify an event registered to a network so that it spans routes.
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_feature_class = "c:/data.gdb/LRS/Event1"
event_id_field = "EventID"
route_id_field = "FromRouteId"
from_date_field = "FromDate"
to_date_field = "ToDate"
loc_error_field = "LocationError"
measure_field = "FromMeasure"
to_measure_field = "ToMeasure"
event_spans_routes = "SPANS_ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE_ROUTE_NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"

# Set current workspace
arcpy.env.workspace = "c:/data.gdb"
 
# Execute the tool
arcpy.locref.ModifyLRSEvent(in_feature_class, event_id_field, route_id_field, from_date_field, to_date_field,
                            loc_error_field, measure_field, to_measure_field, event_spans_routes, to_route_id_field,
                            store_route_name, route_name_field, to_route_name_field)

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

ModifyLRSEvent 示例 2（独立脚本）

以下脚本演示了如何在独立 Python 脚本中使用 ModifyLRSEvent 工具，以使事件跨越路径。

# Name: Modify_LRS_Event_ex2.py
# Description: Modify an event registered to a network so that it spans routes.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables:
in_feature_class = r"C:/data.gdb/LRS/Event1"
event_id_field = "EventID"
route_id_field = "FromRouteId"
from_date_field = "FromDate"
to_date_field = "ToDate"
loc_error_field = "LocationError"
measure_field = "FromMeasure"
to_measure_field = "ToMeasure"
event_spans_routes = "SPANS_ROUTES"
to_route_id_field = "ToRouteId"
store_route_name = "STORE_ROUTE_NAME"
route_name_field = "FromRouteName"
to_route_name_field = "ToRouteName"
 
# Process:  Modify LRS Event From Existing Dataset
arcpy.locref.ModifyLRSEvent(in_feature_class, event_id_field, route_id_field, from_date_field, to_date_field,
                            loc_error_field, measure_field, to_measure_field, event_spans_routes, to_route_id_field,
                            store_route_name, route_name_field, to_route_name_field)

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