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

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

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

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

• Для запуска инструмента необходим набор данных LRS.

  Узнайте больше о создании набора данных LRS в ArcGIS Pipeline Referencing или создании набора данных LRS в ArcGIS Roads and Highways.

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

• Рекомендуется запускать этот инструмент в файловой базе геоданных при первом переносе данных. Так он будет выполняться быстрее, потому что для выполнения этой операции необходимо изменить каждую запись события в базе данных. После запуска инструмент можно запустить на выбранном наборе маршрутов, которые были изменены, чтобы значительно улучшить время исполнения.

• Во входном слое объектов событий должны быть настроены DerivedRouteID и поля измерений.

• Этот инструмент может работать на одном, нескольких или на всех событиях в линейной сети.

• Этот инструмент поддерживает предотвращение конфликтов и будет пытаться получать и передавать блокировки.

• Когда включено предотвращение конфликтов, поддерживаются следующие функции:

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

    Более подробно о предотвращении конфликтов в Pipeline Referencing или о предотвращении конфликтов в Roads and Highways.

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

Параметры

Диалог

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

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

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

Python

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. При больших загрузках данных рекомендуется настроить параметр максимальный возраст файла как минимум на 1 час.	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.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

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

# Execute 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.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

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

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')

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

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

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

# Import arcpy module.
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

## 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_lrs_network = 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_lrs_network, update_all_events, event_layers)

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