叠加事件 (位置参考工具)

汇总

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

插图

“叠加事件”工具图示

用法

下表是上图所示工具的输出：

输出（叠加事件）


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

事件图层参数值可以仅为线事件，也可以同时包含点和线事件。
事件图层参数只能包含注册到 LRS 网络的事件要素类。
注:
- 在“地址数据管理”配置中，配置中心线要素类以与 LRS 配合使用后，该中心线要素类可以用作事件图层参数的输入以进行动态分段。输出中将遵循中心线的数字化方向。
- 在 ArcGIS Utility Network 配置中，配置 Pipeline Line、Pipeline Device 和 Pipeline Junction 要素类以与 LRS 配合使用后，这些要素类可以用作事件图层参数的输入以进行动态分段。
如果输入图层具有来自“地址数据管理”配置的地址范围字段，并且在 LRS 中配置为 Address Range 要素类，则当地址区块分割类型参数值为比例时，将按比例对输出中每个段的地址范围字段中的值进行更新。当参数值为最近地址点时，将根据最近的上游和下游地址点对输出中每个段的地址范围进行更新。

了解有关 LRS 和地址数据管理组合数据集中的分析功能的详细信息
如果输入事件图层使用不同的线性参考方法 (LRM)，则将使用目标网络的 LRM 对其进行转换。
该工具支持针对输入路径要素和事件图层参数值的选择集和定义查询。

注:

要包含与输入路径相关联的所有事件记录，请关闭每个输入事件图层的使用所选记录或使用已过滤记录切换按钮。
此工具支持相应输入事件图层，可将这些图层配置为包含跨多条路径的事件。输出仍将使用网络字段参数值在目标网络的路径级别动态分段。
该工具支持时间分割（时间切片）。此为默认设置，可以通过创建基于时间的定义查询或者将选择集应用于输入来覆盖此设置。
此工具支持使用网络字段参数在输出中包含网络要素类中的一个或多个字段。
可将输出另存为表或要素类。
如果将输出另存为表或要素类，则输出将具有以下索引和字段：
索引

字段
route_id
Route_ID
rid_dates_measures
Route_ID

From_Date

To_Date

From_Measure

To_Measure

索引	字段
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 无效事件测量校验来标识并解决事件数据问题。
当使用要素服务中的数据运行此工具时，如果遇到运行失败或性能低于预期的情况，可在服务级别增加堆大小。
此工具的并行处理因子环境设置仅适用于跨多条路径的事件以及未注册到目标网络的非跨越事件。

标注	说明	数据类型
输入路径要素	将针对其动态分割事件图层的目标网络。	Feature Layer
事件图层	将一起动态分割到目标网络上的事件图层。中心线图层可用作动态分割事件的输入。	Feature Layer
输出数据集	表或要素类，其中包含将创建的输出事件记录。	Table
包括几何（可选）	指定输出数据集参数值是否将包含事件几何。选中—输出数据集参数值将包含事件几何。事件记录将存储为要素类。未选中—输出数据集参数值将不包含事件几何。事件记录将存储为表。这是默认设置。	Boolean
网络字段（可选）	将包含在输出中的网络图层中的字段。	Field
地址区块分割类型（可选）	用于指定将如何针对每个输出段更新地址范围。仅当配置的地址范围图层用作输入事件图层时，此参数才可用。最近地址点—将根据最近的上游和下游地址值对输出中每个段的地址范围进行更新。比例—将根据分割位置按比例对输出中每个段的地址范围进行更新。这是默认设置。	String

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` 参数值是否将包含事件几何。 `INCLUDE_GEOMETRY`—`output_dataset` 参数值将包含事件几何。事件记录将存储为要素类。 `EXCLUDE_GEOMETRY`—`output_dataset` 参数值将不包含事件几何。事件记录将存储为表。这是默认设置。	Boolean
network_fields [network_fields,...] （可选）	将包含在输出中的网络图层中的字段。	Field
address_block_split_type （可选）	用于指定将如何针对每个输出段更新地址范围。仅当配置的地址范围图层用作输入事件图层时，此参数才可用。 `NEAREST_ADDRESS_POINT`—将根据最近的上游和下游地址值对输出中每个段的地址范围进行更新。 `PROPORTIONAL`—将根据分割位置按比例对输出中每个段的地址范围进行更新。这是默认设置。	String

代码示例

OverlayEvents 示例 1（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"

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

OverlayEvents 示例 2（独立脚本）

以下独立脚本演示了如何使用 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

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

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

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

环境

当前工作空间, 并行处理因子

特殊情况

并行处理因子: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores on your machine.

许可信息

基本: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
标准: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
高级: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）

叠加事件 (位置参考工具)

汇总

插图

用法

注:

注:

参数

环境

特殊情况

许可信息

相关主题