Наложение событий (Инструменты 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.
Примечание:
- В Конфигурации управления адресными данными, после конфигурации настройки класса объектов центральной линии для использования с LRS, класс объектов центральной линии может использоваться как входной для параметра Слои событий для динамической сегментации. Направление оцифровки центральной линии учитывается в выходных данных.
- В конфигурации ArcGIS 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

Индекс	Поле
route_id	`Route_ID`
rid_dates_measures	`Route_ID` `From_Date` `To_Date` `From_Measure` `To_Measure`

Если в конфигурации Gas 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` включать геометрию события. `INCLUDE_GEOMETRY`–Значение параметра `output_dataset` будет включать геометрию события. Записи о событиях будут храниться как класс пространственных объектов. `EXCLUDE_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"

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

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

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

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

Параметры среды

Текущая рабочая область, Коэффициент параллельной обработки

Особые случаи

Коэффициент параллельной обработки: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores on your machine.

Информация о лицензировании

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)