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

# 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 (автономный скрипт)

В следующем автономном скрипте показано использование функции 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 = ""
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)

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