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

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

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

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

Иллюстрация

Иллюстрация инструмента Наложение событий

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

  • В следующей таблице приведены выходные данные для инструмента, показанного выше:

    Выходные данные (События наложения)

    ТипИзмерение "От"Измерение "До"Линейное событие 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>

  • Все значения Слоя событий могут быть либо только линейными событиями, либо включать в себя как точечные, так и линейные события.

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

    Примечание:

    Слой центральных линий может быть задан в параметре Слои событий для динамического сегментирования событий, если слой центральных линий является частью решения Управление адресными данными или конфигурации Utility Network. Направление центральной линии учитывается в выходных данных, если слой центральных линий является частью конфигурации решения Управление адресными данными.

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

  • Если входные события используют разные Линейные методы привязки (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"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""

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

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