Получить измерения событий (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

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

# 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 in stand-alone script.
# 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_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

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

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

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