| 标注 | 说明 | 数据类型 |
输入路径要素 | 将针对其动态分割事件图层的目标网络。 | 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 窗口脚本演示了如何使用 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)以下独立脚本演示了如何使用 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）