创建 LRS 事件 (位置参考)

摘要

为现有 LRS 网络创建线或点事件。

使用情况

• 该工具的输出为要素类。

• 派生网络不能用作父网络。

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

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

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

参数

对话框

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

派生输出

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

Python

arcpy.locref.CreateLRSEvent(parent_network, event_name, {geometry_type}, 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
event_name	要注册的事件。	String
geometry_type (可选)	输出事件的几何类型。 POINT—事件的几何类型为“点”。 这是默认设置。 LINE—事件的几何类型为“折线”。	String
event_id_field	事件要素类中可用的事件 ID 字段。	String
route_id_field	如果是不跨越路径的点事件，则为路径 ID 字段的名称；如果 event_spans_routes 参数设置为 SPANS_ROUTES，则为路径始于 ID 字段。	String
from_date_field	事件要素类中可用的开始日期字段。	String
to_date_field	事件要素类中可用的结束日期字段。	String
loc_error_field	事件要素类中可用的位置错误字段。	String
measure_field	如果是点事件，则为测量字段的名称；如果是线事件，则为测量始于字段。	String
to_measure_field (可选)	测量止于字段的名称。 此为线事件的必需项。	String
event_spans_routes (可选)	指定事件记录是否跨越路径。 SPANS_ROUTES—事件记录将跨越路径。 NO_SPANS_ROUTES—事件记录不会跨越路径。 这是默认设置。	Boolean
to_route_id_field (可选)	路径止于 ID 字段的名称。 仅当 geometry_type 参数设置为 LINE 并且 event_span_routes 参数设置为 SPANS_ROUTES 时，此内容才为必需项。	String
store_route_name (可选)	指定是否将路径名称与事件记录一起存储。 STORE_ROUTE_NAME—路径名称将与事件记录一起存储。 NO_STORE_ROUTE_NAME—路径名称不会与事件记录一起存储。 这是默认设置。	Boolean
route_name_field (可选)	如果为不跨越路径的点事件，则为路径名称字段；如果为跨越路径的线事件，则为路径始于名称字段。 如果已设置 STORE_ROUTE_NAME，则此内容为必需项。	String
to_route_name_field (可选)	跨越路径的线事件的“路径止于名称”字段。 如果已设置 STORE_ROUTE_NAME，则此内容为必需项。	String

派生输出

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

代码示例

CreateLRSEvent 示例 1（Python 窗口）

以下脚本演示了如何在 Python 窗口使用 CreateLRSEvent 工具。

# Name: Create_LRS_Event_ex1.py
# Description: Create a new LRS Event registered to an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing 

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

# Tool variables
parent_network = r"C:/data.gdb/LRS/Network"
event_name = "Event1"
geometry_type = "LINE"
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.CreateLRSEvent(parent_network, event_name, geometry_type, 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')

CreateLRSEvent 示例 2（独立脚本）

以下脚本演示了如何在独立 Python 脚本中使用 CreateLRSEvent 工具。

# Name: Create_LRS_Event_ex2.py
# Description: Create a new LRS Event registered to an LRS Network in this stand-alone script.
# 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"
event_name = "Event1"
geometry_type = "LINE"
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:  Create LRS Event From Existing Dataset
arcpy.locref.CreateLRSEvent(parent_network, event_name, geometry_type, 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）