叠加事件 (位置参考)

适用于 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 无效事件测量工具识别并解决事件数据问题。

参数

标注说明数据类型
输入路径要素

将针对其动态分割事件图层的目标网络。

Feature Layer
事件图层

要针对目标网络动态分割的事件图层。

Feature Layer
输出数据集

包含将要创建的输出事件记录的表或要素类。

Table
包括几何
(可选)

指定输出数据集值是否将包括事件几何。

  • 未选中 - 输出数据集值将不包括事件几何。 事件记录将存储为表。 这是默认设置。
  • 选中 - 输出数据集值将包括事件几何。 事件记录将存储为要素类。
Boolean
网络字段
(可选)

来自网络图层的字段将包含在输出中。

Field

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_GEOMETRYoutput_dataset 值将不包括事件几何。 事件记录将存储为表。 这是默认设置。
  • INCLUDE_GEOMETRYoutput_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"
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)
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)

相关主题