Обновить измерения из 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 маршрута	Измерение "От"	Измерение "До"	Комментарии
  Входной слой NonLRS	Линия	Маршрут1	11	18	Геометрия линейных объектов имеет геометрическое соответствие с сетью LRS.

  

  Входной слой	Тип объекта	ID маршрута	Измерение "От"	Измерение "До"	Комментарии
  Входной слой NonLRS	Точка	Маршрут1	21		Точечный объект совпадает с маршрутом в значении Сети 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

Python

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)