Построить калибровочные точки (Инструменты Location Referencing)

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

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

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

Для запуска этого инструмента требуется набор данных LRS.
- Более подробно о создании набора данных LRS в ArcGIS Pipeline Referencing
- Более подробно о создании набора данных LRS в ArcGIS Roads and Highways
Значение параметра Входные полилинейные объекты является базисом для создаваемых калибровочных точек.
Значение параметра Класс объектов калибровочных точек должно быть зарегистрировано с LRS.
Значение параметра Сеть LRS должно быть зарегистрировано с LRS.
Производные сети LRS не поддерживаются в качестве значения параметра Сеть LRS.
Z-значения учитываются при расчете геометрической длины центральных линий.
Правила калибровки промежутков будут соблюдаться при создании калибровочных точек с использованием опций Длина геометрии и Атрибутивные поля для параметра Метод калибровки.

См. более подробно о калибровке маршрутов при помощи реальных промежутков в ArcGIS Roads and Highways или о калибровке маршрутов при помощи реальных промежутков в ArcGIS Pipeline Referencing.
Если для параметра Метод калибровки задано M на маршруте, m-значения будут использоваться в начальной и конечной вершинах входных маршрутов для создания начальной и конечной калибровочных точек.
Когда для параметра Метод калибровки задано значение Атрибутивные поля, инструмент будет делать следующее:
- Опция Атрибутивные поля будет использоваться для оценки полей с типом поля Double для калибровки.
- Значение параметра Поле измерений От будет использоваться, чтобы указать измерение "От" маршрута, а значение параметра Поле измерений До будет использоваться, чтобы указать измерение "До" маршрута.
Значение параметра Входные полилинейные объекты может быть слоем сервиса объектов, который не имеет системы линейных координат. Если значение параметра Класс объектов калибровочных точек является слоем сервиса объектов, для него должна быть включена система линейных координат.

Подпись	Объяснение	Тип данных
Входные полилинейные объекты	Объекты, которые будут использоваться в качестве источника для расчета значений измерений для калибровочных точек.	Feature Layer
Поле ID маршрута	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Тип поля должен соответствовать полю `Route ID` в классе объектов калибровочных точек.	Field
Поле даты "От"	Поле, содержащее значения даты От для маршрута.	Field
Поле даты "До"	Поле, содержащее значения даты До для маршрута.	Field
Класс объектов калибровочных точек	Существующий класс объектов калибровочных точек, к которому будут добавлены новые объекты.	Feature Layer
Сеть LRS	Сеть LRS, для которой будут сгенерированы значения измерений в классе объектов калибровочных точек.	String
Направление калибровки (Дополнительный)	Указывает направление увеличения калибровки на маршруте при создании калибровочных точек. Направление оцифровки–Направление оцифровки отдельного линейного объекта определяет направление калибровки маршрута. Используется по умолчанию. Направление измерений–Направление увеличения m-значений отдельного полилинейного объекта определяет направление калибровки маршрута.Если для отдельного полилинейного объекта m-значения не указаны, будет использоваться направление оцифровки.	String
Метод калибровки (Дополнительный)	Указывает метод, который будет использоваться для определения измерений на маршруте при создании калибровочных точек. Длина геометрии–В качестве метода калибровки будет использоваться геометрическая длина входного объекта маршрута. Используется по умолчанию. M на маршруте–В качестве метода калибровки будут использоваться значения измерений на входном объекте маршрута. Атрибутивные поля–В качестве метода калибровки будут использоваться значения измерений, которые хранятся в атрибутивных полях входного объекта маршрута.	String
Поле измерения "От" (Дополнительный)	Поле, содержащее Измерение От для выбранного маршрута. Этот параметр активен, когда для параметра Метод калибровки задано Атрибутивные поля.	Field
Поле измерения "До" (Дополнительный)	Поле, содержащее Измерение До для выбранного маршрута. Этот параметр активен, когда для параметра Метод калибровки задано Атрибутивные поля.	Field

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

Подпись	Объяснение	Тип данных
Обновленный класс объектов калибровочных точек	Обновленные объекты калибровки	Feature Layer
Выходной файл деталей	Текстовый файл, в котором подробно описаны изменения, внесенные инструментом.	Text File

arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method}, {from_measure_field}, {to_measure_field})

Имя	Объяснение	Тип данных
in_polyline_features	Объекты, которые будут использоваться в качестве источника для расчета значений измерений для калибровочных точек.	Feature Layer
route_id_field	Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Тип поля должен соответствовать полю `Route ID` в классе объектов калибровочных точек.	Field
from_date_field	Поле, содержащее значения даты От для маршрута.	Field
to_date_field	Поле, содержащее значения даты До для маршрута.	Field
in_calibration_point_feature_class	Существующий класс объектов калибровочных точек, к которому будут добавлены новые объекты.	Feature Layer
lrs_network	Сеть LRS, для которой будут сгенерированы значения измерений в классе объектов калибровочных точек.	String
calibration_direction (Дополнительный)	Указывает направление увеличения калибровки на маршруте при создании калибровочных точек. `DIGITIZED_DIRECTION`–Направление оцифровки отдельных линейных объектов определяет направление калибровки маршрута. Используется по умолчанию. `MEASURE_DIRECTION`–Направление увеличения m-значений отдельного полилинейного объекта определяет направление калибровки маршрута.Если для отдельного полилинейного объекта m-значения не указаны, будет использоваться направление оцифровки.	String
calibration_method (Дополнительный)	Указывает метод, который будет использоваться для определения измерений на маршруте при создании калибровочных точек. `GEOMETRY_LENGTH`–В качестве метода калибровки будет использоваться геометрическая длина входного объекта маршрута. Используется по умолчанию. `M_ON_ROUTE`–В качестве метода калибровки будут использоваться значения измерений на входном объекте маршрута. `ATTRIBUTE_FIELDS`–В качестве метода калибровки будут использоваться значения измерений, которые хранятся в атрибутивных полях входного объекта маршрута.	String
from_measure_field (Дополнительный)	Поле, содержащее Измерение От для выбранного маршрута. Этот параметр активен, когда параметр `calibration_method` имеет значение `ATTRIBUTE_FIELDS`.	Field
to_measure_field (Дополнительный)	Поле, содержащее Измерение До для выбранного маршрута. Этот параметр активен, когда параметр `calibration_method` имеет значение `ATTRIBUTE_FIELDS`.	Field

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

Имя	Объяснение	Тип данных
out_calibration_point_feature_class	Обновленные объекты калибровки	Feature Layer
out_details_file	Текстовый файл, в котором подробно описаны изменения, внесенные инструментом.	Text File

Пример кода

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

Пример скрипта окна Python для использования функции GenerateCalibrationPoints с запуском из окна Python.

# Name: GenerateCalibrationPoints_ex1.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in Python window.
# Requires: ArcGIS Location Referencing

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

# Generate Calibration Points tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Run Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

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

В следующем автономном скрипте показано использование функции GenerateCalibrationPoints.

# Name: GenerateCalibrationPoints_ex2.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"C:\\Data\UPDM.gdb\LRS\Calibration_Point"
lrs_network = "EngineeringNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

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

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

# Name: GenerateCalibrationPoints_ex3.py
# Description: Build calibration point features in an existing feature service in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Input LRS route network and calibration point feature class are in feature service.  Signing into portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Map the LRS Network and Calibration Point feature class from the feature service. Here, 5 corresponds to the LRS Network and 1 corresponds to the Calibration Point feature class.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/5"
in_calibration_point_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

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

Текущая рабочая область, Коэффициент параллельной обработки

Особые случаи

Коэффициент параллельной обработки: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores in that machine.

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

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)

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

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

Параметры

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

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

Особые случаи

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

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