Наложение событий (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>

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

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

    Примечание:
    • Класс пространственных объектов центральных линий может быть входными данными для параметра Слои событий для динамической сегментации событий, когда он является частью конфигурацииAddress Data Management или конфигурацииArcGIS Utility Network. Когда класс объектов центральных линий является частью конфигурации Address Data Management, в выходных данных учитывается направление центральной линии.
    • В конфигурации Address Data Management используйте инструмент Настроить классы объектов адресов, чтобы настроить класс объектов центральных линий для использования с LRS.
    • В конфигурации Utility Network используйте инструмент Настроить класс объектов инженерной сети, чтобы настроить класс объектов центральных линий для использования с LRS.
  • Если входной слой содержит поля диапазона адресов из конфигурации Address Data Management и настроен как класс пространственных объектов Диапазон адресов в LRS, значения в полях диапазона адресов будут обновляться для каждого сегмента в выходных данных пропорционально, когда значение параметра Тип разбиения блока адреса задано как Пропорциональное. Если для параметра задано значение Ближайшая адресная точка, диапазоны адресов будут обновлены для каждого сегмента в выходных данных на основе ближайших адресных точек, расположенных по ходу движения и против хода.

    Более подробно о возможностях анализа в объединенном наборе данных LRS и управления адресными данными

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

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

    Примечание:

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

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

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

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

  • Выходные данные могут быть сохранены как таблица или класс пространственных объектов.

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

    ИндексПоле

    route_id

    • Route_ID

    rid_dates_measures

    • Route_ID
    • From_Date
    • To_Date
    • From_Measure
    • To_Measure

  • Если в конфигурации Utility Network существует более одной сети LRS, измерения входных слоев событий будут соответствовать измерениям, указанным во втором столбце следующей таблицы:

    Если LRS с конфигурацией Utility Network содержитИзмерения в классе линейных объектов Pipeline относятся к

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

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

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

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

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

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

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

    Линейная сеть, имеющая наименьший номер в домене с кодированным значением, 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 включать геометрию события.

  • EXCLUDE_GEOMETRYЗначение параметра output_dataset не будет включать геометрию события. Записи о событиях будут храниться в виде таблицы. Используется по умолчанию.
  • INCLUDE_GEOMETRYЗначение параметра output_dataset будет включать геометрию события. Записи о событиях будут храниться как класс пространственных объектов.
Boolean
network_fields
[network_fields,...]
(Дополнительный)

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

Field
address_block_split_type
(Дополнительный)

Задает способ обновления диапазонов адресов для каждого сегмента выходных данных.

  • NEAREST_ADDRESS_POINTДиапазоны адресов будут обновлены для каждого сегмента в выходных данных на основе ближайших значений адресов, расположенных по и против хода движения.
  • PROPORTIONALДиапазоны адресов будут обновляться для каждого сегмента в выходных данных пропорционально разделенному местоположению. Используется по умолчанию.

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

String

Пример кода

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 = ""
address_block_split_type = ""

# 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, address_block_split_type)
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 = ""
Address_Block_Split_Type = ""

# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

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

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

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