| 标注 | 说明 | 数据类型 |
输入路径要素 | 将对其上的事件图层进行动态分割的目标网络。 | Feature Layer |
事件图层 | 将一起动态分割到目标网络上的事件图层。 中心线图层可以用作动态分割事件的输入。 | Feature Layer |
输出数据集 | 表或要素类，其中包含将创建的输出事件记录。 | Table |
包括几何 (可选) | 指定输出数据集参数值是否将包含事件几何。
| Boolean |
网络字段 (可选) | 将包含在输出中的网络图层中的字段。 | Field |
地址区块分割类型 (可选) | 用于指定将如何针对每个输出段更新地址范围。 仅当配置的地址范围图层用作输入事件图层时，此参数才可用。
| String |
适用于 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
<空>
事件图层参数值可以仅为线事件，也可以同时包含点和线事件。
事件图层参数只能包含注册到 LRS 网络的事件要素类。
注：
- 当中心线要素类是 Address Data Management 配置或 ArcGIS Utility Network 配置的一部分时，它可以作为事件图层参数的输入以动态分割事件。 当中心线要素类是 Address Data Management 配置的一部分时，输出中将遵循中心线方向。
- 在 Address Data Management 配置中，可以使用配置地址要素类工具来配置与 LRS 配合使用的中心线要素类。
- 在 Utility Network 配置中，可以使用配置公共设施网络要素类工具来配置与 LRS 配合使用的中心线要素类。
如果输入图层具有来自 Address Data Management 配置的地址范围字段，并且在 LRS 中配置为 Address Range 要素类，则当地址区块分割类型参数值为比例时，将按比例对输出中每个段的地址范围字段中的值进行更新。 当参数值为最近地址点时，将根据最近的上游和下游地址点对输出中每个段的地址范围进行更新。
如果输入事件图层使用不同的线性参考方法 (LRM)，则将使用目标网络的 LRM 对其进行转换。
该工具支持针对输入路径要素和事件图层参数值的选择集和定义查询。
注：
要包含与输入路径相关联的所有事件记录，请关闭每个输入事件图层的使用所选记录或使用已过滤记录切换按钮。
此工具支持相应输入事件图层，可将这些图层配置为包含跨多条路径的事件。 输出仍将使用网络字段参数值在目标网络的路径级别动态分段。
该工具支持时间分割（时间切片）。 此为默认设置，可以通过创建基于时间的定义查询或者将选择集应用于输入来覆盖此设置。
此工具支持使用网络字段参数在输出中包含网络要素类中的一个或多个字段。
可将输出另存为表或要素类。
如果将输出另存为表或要素类，则输出将具有以下索引和字段：
索引 字段 route_id
- Route_ID
rid_dates_measures
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
如果 Utility Network 配置中存在多个 LRS 网络，则输入事件图层的测量值将与下表第二列中显示的测量值相匹配：
如果 Utility Network 配置的 LRS 包含 Pipeline Line 要素类中的测量值属于 线网络、非线网络
线网络
线网络
线网络
多个线网络
具有派生网络的线网络
没有任何派生网络的多个线网络
在编码值属性域中具有最低数值的线网络， dLRSNetworks
具有派生网络的多个线网络
在编码值属性域中具有最低数值的线网络， dLRSNetworks
一个非线网络
非线网络
多个非线网络
在编码值属性域中具有最低数值的网络， dLRSNetworks
该工具支持将具有物理间隙的路径和事件分别用作输入路径和输入事件。
每个图层中仅有一个事件位于路段上。 例如，对于名为 Speed Limit 的图层，该图层中仅有一个事件记录位于该段上。 一个路段可以具有多个事件，每个事件均具有自己的事件图层。 可以使用 ArcGIS Data Reviewer 无效事件测量校验来标识并解决事件数据问题。
参数
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})| 名称 | 说明 | 数据类型 |
in_route_features | 将对其上的事件图层进行动态分割的目标网络。 | Feature Layer |
event_layers [event_layers,...] | 将一起动态分割到目标网络上的事件图层。 中心线图层可以用作动态分割事件的输入。 | Feature Layer |
output_dataset | 表或要素类，其中包含将创建的输出事件记录。 | Table |
include_geometry (可选) | 指定 output_dataset 参数值是否将包含事件几何。
| Boolean |
network_fields [network_fields,...] (可选) | 将包含在输出中的网络图层中的字段。 | Field |
address_block_split_type (可选) | 用于指定将如何针对每个输出段更新地址范围。
仅当配置的地址范围图层用作输入事件图层时，此参数才可用。 | String |
代码示例
以下 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 = ""
address_block_split_type = ""
# 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, address_block_split_type)以下 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 = ""
Address_Block_Split_Type = ""
# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# Check in license
arcpy.CheckInExtension('LocationReferencing')以下独立脚本演示了如何将 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 sign in 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, while 2 and 3 corresponds to the 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 = ""
Address_Block_Split_Type = ""
# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# 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）