叠加事件 (位置参考)

适用于 Location Referencing 许可。

摘要

可将一个或多个线和点事件图层叠加到目标网络，并输出表示输入动态分段的要素类或表。

插图

使用情况

• 下表为上述工具图示的输出：

  输出（叠加事件）

  类型	测量始于	测量止于	线事件 1	线事件 2	点事件
  线	0	2	A	1	<空>
  点	2	2	A	1	PE1
  线	2	3	A	1	<空>
  线	3	4	B	1	<空>
  线	4	5	B	2	<空>

• 所有事件图层值可以仅为线事件，也可以同时包含点和线事件。

• 事件图层参数可以仅包含在 ArcGIS Location Referencing 网络中注册的事件要素类。

  注：

  当中心线图层为地址数据管理解决方案或 Utility Network 配置的一部分时，可以将中心线图层输入到事件图层参数以动态分段事件。 当中心线图层为“地址数据管理”解决方案配置的一部分时，输出中会遵循中心线方向。

• 如果输入图层包含来自地址数据管理配置的地址范围字段，并在 LRS 中配置为地址要素类，则输出中每个段的地址范围字段值将会更新。

• 如果输入事件使用不同的线性参考方法 (LRM)，则它们将使用目标网络的 LRM 进行转换。

• 此外，该工具支持输入路径要素和事件图层参数的选择集。

• 此外，该工具支持输入路径要素和事件图层参数的定义过滤器。

• 此工具支持配置为包含跨越多条路径的事件的输入事件图层值。 输出仍将使用网络字段参数值在目标网络的路径级别动态分段。

• 该工具支持时间分割（时间片段）。 将默认进行此操作，并且可以通过创建基于时间的定义查询或将选择集应用于输入来覆盖。

• 此工具支持使用网络字段参数在输出中包含来自网络要素类的一个或多个字段。

• 输出可以另存为表或要素类。

• 如果将输出另存为表或要素类，则输出将具有以下索引和字段：

  索引	字段
  Route_ID	Route_ID
  Rid_Dates_Me	Route_ID From_Date To_Date From_Measure To_Measure

• 如果已使用配置公共设施网络要素类工具将此要素类配置为与 LRS 一起使用，则此工具支持将天然气 Utility Network 配置管道要素图层作为输入事件图层。

• 如果燃气 Utility Network 配置中存在多个 LRS 网络，则输入事件图层的测量值将与下表第二列中显示的测量值相匹配。

  如果带有 Utility Network 配置的 LRS 包含	PipelineLine 要素类中的测量值属于
  线网络，非线网络	线网络
  线网络	线网络
  多于一个线网络	具有派生网络的线网络
  超过一个线网络不具有派生网络	编码值域中编号最小的线网络， dLRSNetworks
  超过一个线网络具有派生网络	编码值域中编号最小的线网络， dLRSNetworks
  一个非线网络	非线网络
  多于一个非线网络	编码值域中编号最小的网络， dLRSNetworks

• 此工具支持将物理间距路径和事件分别用作输入路径和输入事件。

• 每个图层只能有一个事件位于路径线段上。 例如，对于名为 Speed Limit 的图层，该图层中只有一个事件记录可以在该分段上。 一个分段可以包含多个事件，每个事件都在它自己的事件图层中。 使用 ArcGIS Data Reviewer 无效事件测量勾选框识别并解决事件数据问题。

参数

对话框

标注	说明	数据类型
输入路径要素	将针对其动态分割事件图层的目标网络。	Feature Layer
事件图层	要针对目标网络动态分割的事件图层。 中心线图层可用作动态分割事件的输入。	Feature Layer
输出数据集	包含将要创建的输出事件记录的表或要素类。	Table
包括几何 (可选)	指定输出数据集参数值是否将包括事件几何。 未选中 - 输出数据集参数值将不包括事件几何。 事件记录将存储为表。 这是默认设置。 选中 - 输出数据集参数值将包括事件几何。 事件记录将存储为要素类。	Boolean
网络字段 (可选)	来自网络图层的字段将包含在输出中。	Field

Python

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields})

名称	说明	数据类型
in_route_features	将针对其动态分割事件图层的目标网络。	Feature Layer
event_layers [event_layers,...]	要针对目标网络动态分割的事件图层。 中心线图层可用作动态分割事件的输入。	Feature Layer
output_dataset	包含将要创建的输出事件记录的表或要素类。	Table
include_geometry (可选)	指定 output_dataset 参数值是否将包括事件几何。 EXCLUDE_GEOMETRY—该 output_dataset 参数值将不包括事件几何。 事件记录将存储为表。 这是默认设置。 INCLUDE_GEOMETRY—该 output_dataset 参数值将包括事件几何。 事件记录将存储为要素类。	Boolean
network_fields [network_fields,...] (可选)	来自网络图层的字段将包含在输出中。	Field

代码示例

OverlayEvents 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在 Python 窗口中使用 OverlayEvents 函数。

# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing

# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""

# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"

# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields)

OverlayEvents 示例 2（独立脚本）

以下 Python 脚本演示了如何在独立 Python 脚本中使用 OverlayEvents 函数。

# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""

# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields)

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

OverlayEvents 示例 3（独立脚本）

以下独立脚本演示了如何在要素服务中使用 OverlayEvents 函数。

# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

#Input LRS network and events are in feature service. Portal signi is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network and 2 and 3 corresponds to input events.
in_network  = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]

# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""

# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields)

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