Обновить измерения из LRS (Location Referencing)

Доступно с лицензией Location Referencing.

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

Заполняет или обновляет измерения и ID маршрута для пространственных объектов Utility Network (UN), таких как трубы, устройства или соединения, или для пространственных объектов в классах пространственных объектов, не являющихся UN или LRS.

Этот инструмент находит соответствующие маршруты из параметра Сеть LRS, получает измерения из этого маршрута и заполняет или обновляет измерения и атрибуты маршрута для объектов в классе объектов NonLRS.

Примечание:

Для использования этого инструмента при использовании наборов данных из сервиса объектов требуется дополнительный модуль ArcGIS Pipeline Referencing или ArcGIS Roads and Highways.

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

  • Начиная с ArcGIS Pro 3.1, этот инструмент поддерживает прямое подключение (подключение клиента и сервера) с использованием сервис-ориентированных версий, а также ранее поддерживаемое подключение через сервис объектов с использованием сервис-ориентированных версий.

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

  • Пространственная привязка, разрешение x,y и допуск x,y параметров Входные объекты и Сеть LRS должны совпадать.

  • Локально записывается текстовый журнал, в котором указывается, что инструмент был запущен, и содержится следующее:

    • Информация о любых входных объектах, для которых выполнить проверку не удалось
    • ID маршрута и значения измерений для обновленных входных объектов до и после обновления

  • Значение Входных объектов должно точно совпадать с объектами Сети LRS.

    Следующие схемы и таблицы показывают, как будут обновлены линейные и точечные объекты из значений Входных объектов, которые не являются классами объектов LRS, но совпадают с Route1 в объектах Сети LRS Network:

    Пример обновления значений ID маршрута с использованием линейного объекта

    Входной слойТип объектаID маршрутаИзмерение "От"Измерение "До"Комментарии

    Входной слой NonLRS

    Линия

    Маршрут1

    11

    18

    Геометрия линейных объектов имеет геометрическое соответствие с сетью LRS.

    Пример обновления значений ID маршрута с использованием точечного объекта

    Входной слойТип объектаID маршрутаИзмерение "От"Измерение "До"Комментарии

    Входной слой NonLRS

    Точка

    Маршрут1

    21

    Точечный объект совпадает с маршрутом в значении Сети LRS.

    Пример значений ID маршрута, которые не могут быть обновлены, поскольку линейный объект не точно совпадает с сетью LRS

    Входной слойТип объектаID маршрутаИзмерение "От"Измерение "До"Комментарии

    Входной слой NonLRS

    Линия

    Геометрия линейных объектов не совпадает с входной сетью. Никакая информация не возвращена.

Параметры

ПодписьОписаниеТип данных
Сеть LRS

Векторный слой, содержащий маршруты, ID маршрутов и измерения.

Feature Layer
Дата LRS

Данные, используемые для определения временного представления сети для сбора значений маршрута и измерений.

Date
Входные объекты

Слой, включающий ID маршрута и поля измерений, которые будут обновляться на основе геометрии пространственных объектов относительно маршрутов в параметре Cеть LRS.

Feature Layer
Поле Id маршрута

Поле в слое Входные объекты, содержащее значение ID маршрута.

Field
Поле измерения

Поле в слое Входные объекты, содержащее значение "Измерение От" для полилинейных объектов.

Field
Поле измерения "До"
(Дополнительный)

Поле в слое Входные объекты, содержащее значение измерения для точечных объектов или значение "Измерение До" для полилинейных объектов.

Field

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

ПодписьОписаниеТип данных
Выходной файл деталей

Выходной файл журнала, в котором перечислены обновленные объекты из параметра Входные объекты. Этот файл журнала будет содержать значения "до" и "после" для ID маршрута, полей Измерение "От" и Измерение До" для каждого обновленного объекта.

Text File
Выходные объекты

Обновленный слой объектов.

Примечание:

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

Feature Layer

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field})
ИмяОписаниеТип данных
lrs_network

Векторный слой, содержащий маршруты, ID маршрутов и измерения.

Feature Layer
lrs_date

Данные, используемые для определения временного представления сети для сбора значений маршрута и измерений.

Date
in_features

Слой, включающий ID маршрута и поля измерений, которые будут обновляться на основе геометрии пространственных объектов относительно маршрутов в параметре lrs_network.

Feature Layer
route_id_field

Поле в слое in_features, содержащее значение ID маршрута.

Field
from_measure_field

Поле в слое in_features, содержащее значение "Измерение От" для полилинейных объектов.

Field
to_measure_field
(Дополнительный)

Поле в слое in_features, содержащее значение измерения для точечных объектов или значение "Измерение До" для полилинейных объектов.

Field

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

ИмяОписаниеТип данных
out_details_file

Выходной файл журнала, в котором перечислены обновленные объекты из параметра in_features. Этот файл журнала будет содержать значения "до" и "после" для ID маршрута, полей Измерение "От" и Измерение До" для каждого обновленного объекта.

Text File
out_features

Обновленный слой объектов.

Примечание:

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

Feature Layer

Пример кода

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

Этот пример кода демонстрирует, как применять функцию UpdateMeasuresFromLRS в окне Python.

# Name: UpdateMeasuresFromLRS_Sample1.py
# Description: This will populate the Route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

## Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date="10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field)
UpdateMeasuresFromLRS, пример 2 (автономный скрипт Python)

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

# Name: UpdateMeasuresFromLRS_Sample2.py
# Description: Populate the route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

## Variables are supported from feature service only. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables
# Map the lrs network from the feature service. Here, 8 corresponds to the LRS route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date="10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field)

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

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