标注 | 说明 | 数据类型 |
输入路径要素 | 将针对其动态分割事件图层的目标网络。 | Feature Layer |
事件图层 | 要针对目标网络动态分割的事件图层。 | Feature Layer |
输出数据集 | 包含将要创建的输出事件记录的表或要素类。 | Table |
包括几何 (可选) | 指定输出数据集值是否将包括事件几何。
| Boolean |
网络字段 (可选) | 来自网络图层的字段将包含在输出中。 | Field |
适用于 Location Referencing 许可。
摘要
针对目标网络覆盖一个或多个线性事件要素图层,并输出表示输入动态分段的要素类或表。
使用情况
所有输入事件图层必须为线事件。
事件图层参数可能仅包括在 ArcGIS Location Referencing 网络中注册的线事件要素类。
如果输入事件使用不同的线性参考方法 (LRM),则它们将使用目标网络的 LRM 进行转换。
此工具支持选择集。
此工具支持定义过滤器。
此工具支持配置为包含跨越多条路径的事件的输入事件图层值。 输出仍将使用网络字段参数在目标网络的路径级别动态分段。
该工具支持时间分割(时间片段)。 将默认进行此操作,并且可以通过创建基于时间的定义查询或将选择集应用于输入来覆盖。
此工具支持使用网络字段参数在输出中包含来自网络要素类的一个或多个字段。
输出可以另存为表或要素类。
如果将输出另存为表或要素类,则输出将具有以下索引和字段:
索引 字段 Route_ID
- Route_ID
Rid_Dates_Me
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
如果目标 LRS 网络配置为支持多字段路径 ID 的线网络,则追加路径不需要以下参数:
- “路径名称”字段
- 线名称字段
如果已使用配置 Utility Network 要素类工具将此要素类配置为与 LRS 一起使用,则此工具支持将天然气 Utility Network 配置管道要素图层作为输入事件图层。
如果燃气 Utility Network 配置中存在多个 LRS 网络,则输入事件图层的测量值将与下表右列中显示的测量值相匹配。
如果带有 Utility Network 配置的 LRS 包含 PipelineLine 要素类中的测量值属于 线网络,非线网络
线网络
线网络
线网络
多于一个线网络
具有派生网络的线网络
超过一个线网络不具有派生网络
编码值域中编号最小的线网络, dLRSNetworks
超过一个线网络具有派生网络
编码值域中编号最小的线网络, dLRSNetworks
一个非线网络
非线网络
多于一个非线网络
编码值域中编号最小的网络, dLRSNetworks
此工具支持将物理间距路径和事件分别用作输入路径和输入事件。
每个图层只能有一个事件位于路径线段上。 例如,对于名为 Speed Limit 的图层,该图层中只有一个事件记录可以在该分段上。 一个分段可以包含多个事件,每个事件都在它自己的事件图层中。 使用 ArcGIS Data Reviewer 无效事件测量工具识别并解决事件数据问题。
参数
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 值是否将包括事件几何。
| Boolean |
network_fields [network_fields,...] (可选) | 来自网络图层的字段将包含在输出中。 | Field |
代码示例
以下 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"
include_geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
# Set current workspace
arcpy.env.workspace = "C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, include_geometry, network_fields)
以下 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 函数。
# 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)