Наложение событий (Location Referencing)

Доступно с лицензией Location Referencing.

Краткая информация

Выполняет наложение одного или более линейных векторных слоев событий на целевую сеть, и выдает в результате класс объектов или таблицу, которая представляет динамическую сегментацию входных данных.

Использование

  • Все входные значения Слои событий должны быть линейными событиями.

  • Параметр Слои событий может включить только линейные классы объектов событий, которые зарегистрированы с сетью ArcGIS Location Referencing.

  • Если входные события используют разные Линейные методы привязки (LRM), то они будут переведены с помощью LRM целевой сети.

  • Этот инструмент поддерживает наборы выборок.

  • Этот инструмент поддерживает определяющие фильтры

  • Этот инструмент поддерживает входные значения Слоев событий, настроенные таким образом, чтобы содержать события, охватывающие несколько маршрутов. Выходные данные по-прежнему будут динамически сегментироваться на уровне маршрута целевой сети с помощью параметра Сетевые поля.

  • Этот инструмент поддерживает временную сегментацию (временные срезы). Это будет происходить по умолчанию и может быть переопределено путем создания определяющего запроса по времени или применения набора выборки к входным данным.

  • Этот инструмент поддерживает включение одного или нескольких полей из класса сетевых объектов в выходные данные с помощью параметра Сетевые поля.

  • Результат можно сохранить либо как таблица, либо как класс пространственных объектов.

  • Если результат сохраняется как таблица или класс объектов, то у результата будут следующие индексы и поля:

    ИндексПоле

    Route_ID

    • Route_ID

    Rid_Dates_Me

    • Route_ID
    • From_Date
    • To_Date
    • From_Measure
    • To_Measure

  • Этот инструмент поддерживает слой пространственных объектов трубопровода Gas Utility Network Configuration в качестве входного слоя событий, если этот класс объектов был настроен для использования с LRS с помощью инструмента Настроить класс объектов инженерной сети.

  • Если в Gas Utility Network Configuration существует более одной Сети LRS, измерения для входных слоев событий будут соответствовать измерениям, показанным в правом столбце таблицы ниже.

    Если LRS с Utility Network Configuration содержитИзмерения в классе объектов PipelineLine принадлежат

    Линейная сеть, нелинейная сеть

    Линейная сеть

    Линейная сеть

    Линейная сеть

    Более одной линейной сети

    Линейная сеть, которая уже имеет производную сеть

    Более одной линейной сети без какой-либо производной сети

    Линейная сеть, имеющая наименьший номер в домене кодированных значений, dLRSNetworks

    Более одной линейной сети с производными сетями

    Линейная сеть, имеющая наименьший номер в домене кодированных значений, dLRSNetworks

    Одна нелинейная сеть

    Нелинейная сеть

    Более одной нелинейной сети

    Сеть, имеющая наименьший номер в домене кодированных значений, dLRSNetworks

  • Этот инструмент поддерживает маршруты и события с реальными промежутками в качестве входных маршрутов и входных событий соответственно.

  • На сегменте маршрута может быть только одно событие для каждого слоя. Например, для слоя с именем Ограничения скорости в этом сегменте может быть только одна запись события в этом слое. Сегмент может содержать несколько событий, каждое из которых находится в своем собственном слое событий. Используйте инструмент 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_GEOMETRYЗначение output_dataset не будет включать геометрию событий. Записи событий будут сохранены как таблица. Это значение по умолчанию
  • INCLUDE_GEOMETRYЗначение output_dataset будет включать геометрию событий. Записи событий будут сохранены как класс объектов.
Boolean
network_fields
[network_fields,...]
(Дополнительный)

Поля из сетевого слоя, которые будут включены в результат.

Field

Пример кода

OverlayEvents, пример 1 (окно Python)

Следующий скрипт окна Python, демонстрирующий использование функции OverlayEvents в окне Python.

# 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 демонстрирует пример использования функции OverlayEvents в автономном скрипте Python.

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

Связанные разделы