Создать калибровочные точки (Location Referencing)

Доступно с лицензией 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.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

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

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

# Execute 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.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
GenerateCalibrationPoints пример 3 (автономный скрипт)

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

# Name: GenerateCPs_Pro_standalone_fs.py
# Description: Build calibration point features in an existing feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing"

# Local 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"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

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

# Map the calibration point layer from the feature service. Here, 5 corresponds to the calibration point layer.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Execute the tool
arcpy.locref.GenerateCalibrationPoints(in_calibration_point_feature_class)

# 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)
                                                         
## Check in license
arcpy.CheckInExtension('LocationReferencing')

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

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

Коэффициент параллельной обработки

Значение по умолчанию для этого параметра среды, если оно оставлено пустым, равно 0%. Любое абсолютное значение параметра среды всегда заключено между 0 и количеством логических ядер данного компьютера.

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

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

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