创建 LRS 事件 (位置参考)

摘要

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

使用情况

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

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

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

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

    活动规则

    校准路径

    固定不动

    停用路径

    固定不动

    扩展路径

    固定不动

    重新分配路径

    固定不动

    重新对齐路径

    固定不动

    制图重新对齐路径

    支持路径测量

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

参数

标注说明数据类型
父 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

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
  • Standard: 需要 ArcGIS Location Referencing
  • Advanced: 需要 ArcGIS Location Referencing

相关主题