Получить измерения событий (Инструменты Location Referencing)

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

Заполняет и обновляет поле DerivedRouteID и значения измерений на точечных и линейных событиях, когда эти поля настроены и подключены.

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

Для запуска этого инструмента требуется набор данных LRS.
- Подробнее о модели данных LRS в ArcGIS Pipeline Referencing
- Подробнее о создании набора данных LRS в ArcGIS Roads and Highways
Этот инструмент предназначен для запуска как часть более масштабного рабочего процесса. Запустите инструменты Применить поведение событий и Построить маршруты перед тем, как запустить Получить измерения событий. Применение этого инструмента без запуска предыдущих инструментов в этом рабочем процессе может привести к неточным данным.
Рекомендуется запускать этот инструмент в файловой базе геоданных при первом переносе данных. Так он будет выполняться быстрее, потому что для выполнения этой операции необходимо изменить каждую запись события в базе данных. После запуска инструмент можно запустить на выбранном наборе маршрутов, которые были изменены, чтобы значительно улучшить время исполнения.
Во входном слое объектов событий должно быть настроено поле DerivedRouteID и поля измерений.
Выборка наборов для входного слоя объектов маршрута учитываются.
Выборка наборов в слоях событий игнорируется и не учитывается.
Этот инструмент может работать на одном, нескольких или на всех событиях в линейной сети.
Этот инструмент поддерживает предотвращение конфликтов и пытается получить и перенести блокировки.
Когда включено предотвращение конфликтов, поддерживается следующее:
- События, производные измерения которых необходимо обновить, автоматически получат блокировки событий, если таковые имеются. Если блокировки получить невозможно, инструмент завершит работу с ошибкой и предоставит текстовый файл этих блокировок.
  
  Подробнее о предотвращении конфликтов в Pipeline Referencing или предотвращении конфликтов в ArcGIS Roads and Highways.
- При работе в версии по умолчанию полученные блокировки будут автоматически сняты по завершении работы инструмента.
- При работе в именованной версии полученные блокировки по завершении работы инструмента останутся в статусе On Post. Необходимо закрепить или удалить версию, чтобы снять блокировки.
- При работе в именованной версии, если запуск инструмента отменен из-за прерывания, полученные блокировки останутся в состоянии снятия.

Подпись	Объяснение	Тип данных
Входные объекты-маршруты	Сеть LRS, содержащая события с полем `DerivedRouteID` и настроенными полями измерений.	Feature Layer
Обновить все классы объектов событий, зарегистрированные в выбранной сети (Дополнительный)	Указывает, будут ли обновляться все классы объектов событий в сети. Отмечено–Будут обновлены все классы объектов событий в данной сети, выбранные в значении параметра Входные объекты-маршруты. Используется по умолчанию. Не отмечено–Будут обновлены все классы объектов событий в данной сети, выбранные в значении параметра Входные объекты-маршруты. Могут быть выбраны отдельные слои событий с помощью параметра Слои событий.	Boolean
Слои событий (Дополнительный)	Слои событий, содержащие поле `DerivedRouteID` и поля измерений обновлены.	Feature Layer

Производные выходные данные

Подпись	Объяснение	Тип данных
Выходные события	Обновленный векторный слой событий.	Feature Layer
Выходной файл деталей	Текстовый файл, содержащий подробную информацию об изменениях, внесенных в слой объектов событий. Примечание: Результаты проверки этого инструмента записываются в директорию ArcGIS Server. По умолчанию этот файл автоматически очищается каждые 10 минут, этого может быть недостаточно для обработки всех проверок и их записи в вашу рабочую станцию, запускающую ArcGIS Pro. При больших объемах данных рекомендуется установить максимальный возраст файла как минимум на один час.	Text File

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})

Имя	Объяснение	Тип данных
in_route_features	Сеть LRS, содержащая события с полем `DerivedRouteID` и настроенными полями измерений.	Feature Layer
update_all_events (Дополнительный)	Указывает, будут ли обновляться все классы объектов событий в сети. `UPDATE_ALL`–Будут обновляться все классы объектов событий, выбранные в значении параметра `in_route_features`. Используется по умолчанию. `UPDATE_SOME`–Не будет обновляться ни один из классов объектов событий в сети, выбранных в значении параметра `in_route_features`. С помощью параметра `event_layers` можно выбрать отдельные слои событий.	Boolean
event_layers [event_layers,...] (Дополнительный)	Слои событий, содержащие поле `DerivedRouteID` и поля измерений обновлены.	Feature Layer

Производные выходные данные

Имя	Объяснение	Тип данных
out_events	Обновленный векторный слой событий.	Feature Layer
out_details_file	Текстовый файл, содержащий подробную информацию об изменениях, внесенных в слой объектов событий. Примечание: Результаты проверки этого инструмента записываются в директорию ArcGIS Server. По умолчанию этот файл автоматически очищается каждые 10 минут, этого может быть недостаточно для обработки всех проверок и их записи в вашу рабочую станцию, запускающую ArcGIS Pro. При больших объемах данных рекомендуется установить максимальный возраст файла как минимум на один час.	Text File

Пример кода

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

В следующем скрипте окна Python показано, как используется функция DeriveEventMeasures в режиме прямого запуска.

# Name: DeriveEventMeasures_ex1.py
# Description: Populate and update the Derived RouteID and measure values on point and line events with those fields configured and enabled in Python window.
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace = r"C:\Data\PipelineReferencing.gdb"

# Local variables
in_route_features = "LineNetwork"
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

# Run the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

DeriveEventMeasures, пример 2 (автономный скрипт)

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

# Name: DeriveEventMeasures_ex2.py
# Description: Populate and update the Derived routeID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_ALL"
event_layers = ""

# Run the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

DeriveEventMeasures, пример 3 (автономный скрипт)

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

# Name: DeriveEventMeasures_ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Input LRS Route Network is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input route network from the feature service. Here, 3 corresponds to the input route network.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Set tool variables.
update_all_events = "UPDATE_ALL"
event_layers = ""

# Process : Derive Event Measures.
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

Текущая рабочая область

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

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)

Получить измерения событий (Инструменты Location Referencing)

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

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

Параметры

Производные выходные данные

Примечание:

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

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

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