基于现有数据集创建 LRS 事件 (位置参考)

摘要

将现有要素类注册为 LRS 事件。

使用情况

• 事件要素类必须位于包含 LRS 数据集的要素数据集中。

  了解有关 Pipeline Referencing 数据模型中的 LRS 数据集或 Roads and Highways 数据模型中的 LRS 数据集的详细信息。

• 事件要素类字段必须包含在 Pipeline Referencing 事件数据模型或 Roads and Highways 事件数据模型中指定的属性。

• 默认情况下，将设置以下事件行为规则：

  活动	规则
  校准路径	固定不动
  停用路径	固定不动
  扩展路径	固定不动
  重新分配路径	固定不动
  重新对齐路径	固定不动
  制图重新对齐路径	支持路径测量

• 使用企业级地理数据库作为此工具的输入时，当前数据库用户不能为 SDE 或 DBO。

参数

对话框

标注	说明	数据类型
父 LRS 网络	事件将注册到的网络。	Feature Layer
事件要素类	要注册的事件。	Feature Layer
事件 ID 字段	事件要素类中的事件 ID 字段。	Field
路径 ID 字段	如果要素类是不跨越路径的点事件，则为路径 ID 字段；如果要素类是跨越路径的线事件，则为路径始于 ID 字段。	Field
开始日期字段	事件要素类中的开始日期字段。	Field
结束日期字段	事件要素类中的结束日期字段。	Field
位置错误字段	事件要素类中的位置错误字段。	Field
测量字段	如果要素类是点事件，则为测量字段；如果要素类是线事件，则为测量始于字段。	Field
测量止于字段 (可选)	事件要素类中的测量止于字段。 此参数为线路事件的必需项。	Field
事件跨越路径 (可选)	指定事件记录是否跨越路径。 选中 - 事件记录将跨越路径。 未选中 - 事件记录不会跨越路径。 这是默认设置。	Boolean
“路径止于 ID”字段 (可选)	跨越路径的事件的路径 ID 字段。 如果事件要素类几何类型为折线，则此参数为必需项。	Field
存储路径名称 (可选)	指定是否将路径名称与事件记录一起存储。 选中 - 路径名称将与事件记录一起存储。 未选中 - 路径名称不会与事件记录一起存储。 这是默认设置。	Boolean
“路径名称”字段 (可选)	如果要素类是不跨越路径的点事件，则为路径名称字段；如果要素类是跨越路径的线事件，则为路径始于名称字段。 如果选中存储路径名称，则该参数为必需项。	Field
“路径止于名称”字段 (可选)	跨越路径的线事件的“路径止于名称”字段。 如果选中存储路径名称，则该参数为必需项。	Field

派生输出

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

Python

arcpy.locref.CreateLRSEventFromExistingDataset(parent_network, 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})

名称	说明	数据类型
parent_network	事件将注册到的网络。	Feature Layer
in_feature_class	要注册的事件。	Feature Layer
event_id_field	事件要素类中的事件 ID 字段。	Field
route_id_field	如果要素类是点事件，则为路径 ID 字段；如果要素类是线事件并 event_spans_routes 设置为 SPANS_ROUTES，则为路径始于 ID 字段。	Field
from_date_field	事件要素类中的开始日期字段。	Field
to_date_field	事件要素类中的结束日期字段。	Field
loc_error_field	事件要素类中的位置错误字段。	Field
measure_field	如果要素类是点事件，则为测量字段；如果要素类是线事件，则为测量始于字段。	Field
to_measure_field (可选)	事件要素类中的测量止于字段。 此参数为线路事件的必需项。	Field
event_spans_routes (可选)	指定事件记录是否跨越路径。 NO_SPANS_ROUTES—事件记录不会跨越路径。 这是默认设置。 SPANS_ROUTES—事件记录将跨越路径。	Boolean
to_route_id_field (可选)	跨越路径的事件的路径 ID 字段。 如果 in_feature class 参数几何类型为折线并且 event_spans_routes 设置为 SPANS_ROUTES，则此参数为必需项。	Field
store_route_name (可选)	指定是否将路径名称与事件记录一起存储。 NO_STORE_ROUTE_NAME—路径名称不会与事件记录一起存储。 这是默认设置。 STORE_ROUTE_NAME—路径名称将与事件记录一起存储。	Boolean
route_name_field (可选)	如果要素类是不跨越路径的点事件，则为路径名称字段；如果要素类是跨越路径的线事件，则为路径始于名称字段。 如果将 store_route_name 设置为 STORE_ROUTE_NAME，则此参数为必需项。	Field
to_route_name_field (可选)	跨越路径的线事件的“路径止于名称”字段。 如果将 store_route_name 设置为 STORE_ROUTE_NAME，则此参数为必需项。	Field

派生输出

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

代码示例

CreateLRSEventFromExistingDataset 示例 1（Python 窗口）

以下脚本使用 Python 窗口中的 CreateLRSEventFromExistingDataset 函数从现有数据集创建了 LRS 事件。

# Name: CreateLRSNetworkFromExisting_ex5.py
# Description: Create an LRS Event from an existing dataset.
# Requires: ArcGIS Location Referencing

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

# Tool variables
parent_network = r"C:\data.gdb\LRS\Network"
in_feature_class = r"C:\data.gdb\LRS\Event"
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.CreateLRSEventFromExistingDataset(parent_network, 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')

CreateLRSEventFromExistingDataset 示例 2（独立脚本）

以下脚本使用独立 Python 脚本中的 CreateLRSEventFromExistingDataset 函数从现有数据集创建了 LRS 事件。

# Name: Create_LRS_Event_From_Existing_Dataset_ex2.py
# Description: Registers an existing feature class as an event.
# Requires: ArcGIS Location Referencing 

# Import arcpy module
import arcpy 

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

# Local variables 
parent_network = r"C:\data.gdb\LRS\Network"
in_feature_class = r"C:\data.gdb\LRS\Event"
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"


# Execute the tool
arcpy.locref.CreateLRSEventFromExistingDataset(parent_network, 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）