Калибровка маршрута (Системы линейных координат)

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

Пересчет измерений на маршруте с использованием точек.

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

  • Можно калибровать как маршруты целиком, так и их части. Вы можете выполнить интерполяцию между входными точками, экстраполяцию до входных точек, экстраполяцию после входных точек, или использовать любую комбинацию из этих методов.

  • Используйте инструмент Создать векторный слой или Создать таблицу запроса, чтобы значительно сократить маршруты, которые будут подвергнуты калибровке.

  • Если Выходной класс объектов-маршрутов будет записан в базу геоданных, задайте соответствующие параметры среды Допуск M, Разрешение M и Домен М.

  • Значение параметра Выходной класс объектов маршрутов будет включать все поля из значения параметра Входные объекты маршрутов:

  • Параметр среды Выходные данные содержат M-значения игнорируется. Значение параметра Выходной класс объектов-маршрутов будет содержать значения М (значения измерений).

  • Нельзя указывать радиус поиска, равный бесконечности.

  • Атрибутивный индекс на поле идентификатора маршрута ускоряет процесс динамической сегментации (dynamic segmentation). Если вы будете использовать значение параметра Выходной класс объектов-маршрутов для динамической сегментации, рекомендуется создать атрибутивный индекс.

  • Если какие-либо пространственные объекты обрабатываются с помощью этого инсрумента, создается временный текстовый файл для хранения информации об этих объектах, например C:\Users\patrickb\AppData\Local\Temp\Calibrate_Output0.txt (где Calibrate_Output - это имя Значения параметра Выходной класс объектов маршрутов).

Параметры

ПодписьОписаниеТип данных
Входные объекты-маршруты

Объекты маршрутов, которые будут откалиброваны.

Feature Layer
Поле идентификатора маршрута

Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID.

Field
Входные точечные объекты

Точечные объекты, которые будут использоваться для калибровки маршрутов.

Feature Layer
Поле идентификатора маршрута для точек

Поле, определяющее, на каком из маршрутов находится каждая точка. Значения в этом поле должны соответствовать значениям в поле идентификатора маршрута. Это поле может быть числовым, текстовым или GUID.

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

Поле, содержащее значения измерений для каждой калибровочной точки. Это поле должно быть числовым.

Field
Выходной класс объектов-маршрутов

Класс пространственных объектов, который будет создан. Это может быть шейп-файл или класс объектов базы геоданных.

Feature Class
Метод расчета измерений
(Дополнительный)

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

  • РасстояниеИзмерения будут пересчитываться на основе кратчайшего пути между калибровочными точками. Это значение по умолчанию
  • ИзмеренияИзмерения будут пересчитываться на основании существующих измерений между калибровочными точками.
String
Радиус поиска
(Дополнительный)

Ограничивает, насколько далеко от маршрута может располагаться калибровочная точка. Если единицы измерения неизвестны, будут использоваться единицы системы координат класса объектов маршрутов.

Linear Unit
Интерполировать между калибровочными точками
(Дополнительный)

Определяет, будут ли интерполироваться значения измерений между калибровочными точками.

  • Отмечено - значения измерений будут интерполироваться между калибровочными точками. Это значение по умолчанию
  • Не отмечено - значения измерений не будут интерполироваться между калибровочными точками.
Boolean
Экстраполировать перед калибровочными точками.
(Дополнительный)

Определяет, будут ли экстраполироваться значения перед калибровочными точками.

  • Отмечено - значения измерений будут экстраполироваться перед калибровочными точками. Это значение по умолчанию
  • Не отмечено - значения измерений не будут экстраполироваться перед калибровочными точками.
Boolean
Экстраполировать после калибровочных точек
(Дополнительный)

Определяет, будут ли экстраполироваться значения после калибровочных точек.

  • Отмечено - значения измерений будут экстраполироваться после калибровочных точек. Это значение по умолчанию
  • Не отмечено - значения измерений не будут экстраполироваться после калибровочных точек.
Boolean
Игнорировать разрывы
(Дополнительный)

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

  • Отмечено – пространственные разрывы будут проигнорированы. Для разорванных маршрутов измерения будут непрерывными. Это значение по умолчанию
  • Не отмечено – Пространственные разрывы не будут проигнорированы. Значения измерений на разорванных маршрутах также будут иметь разрывы. Величина разрыва будет вычисляться как расстояние по прямой между конечными точками частей разорванного маршрута.
Boolean
Включить все объекты в выходном классе объектов
(Дополнительный)

Определяет, будут ли объекты-маршруты без калибровочных точек включены в выходной класс объектов.

  • Отмечено - все объекты-маршруты будут включены в выходной класс объектов. Это значение по умолчанию
  • Не отмечено - все объекты-маршруты не будут обязательно включены в выходной класс объектов. Объекты, для которых отсутствуют калибровочные точки, будут исключены.
Boolean
Построить индекс
(Дополнительный)

Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в значение параметра Выходной класс объектов-маршрутов.

  • Отмечено - будет создан атрибутивный индекс. Это значение по умолчанию
  • Не отмечено - атрибутивных индекс не создается.
Boolean

arcpy.lr.CalibrateRoutes(in_route_features, route_id_field, in_point_features, point_id_field, measure_field, out_feature_class, {calibrate_method}, {search_radius}, {interpolate_between}, {extrapolate_before}, {extrapolate_after}, {ignore_gaps}, {keep_all_routes}, {build_index})
ИмяОписаниеТип данных
in_route_features

Объекты маршрутов, которые будут откалиброваны.

Feature Layer
route_id_field

Поле, содержащее значения, которые позволяют уникально идентифицировать каждый маршрут. Поле может быть числовым, текстовым или GUID.

Field
in_point_features

Точечные объекты, которые будут использоваться для калибровки маршрутов.

Feature Layer
point_id_field

Поле, определяющее, на каком из маршрутов находится каждая точка. Значения в этом поле должны соответствовать значениям в поле идентификатора маршрута. Это поле может быть числовым, текстовым или GUID.

Field
measure_field

Поле, содержащее значения измерений для каждой калибровочной точки. Это поле должно быть числовым.

Field
out_feature_class

Класс пространственных объектов, который будет создан. Это может быть шейп-файл или класс объектов базы геоданных.

Feature Class
calibrate_method
(Дополнительный)

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

  • DISTANCEИзмерения будут пересчитываться на основе кратчайшего пути между калибровочными точками. Это значение по умолчанию
  • MEASURESИзмерения будут пересчитываться на основании существующих измерений между калибровочными точками.
String
search_radius
(Дополнительный)

Ограничивает, насколько далеко от маршрута может располагаться калибровочная точка. Если единицы измерения неизвестны, будут использоваться единицы системы координат класса объектов маршрутов.

Linear Unit
interpolate_between
(Дополнительный)

Определяет, будут ли интерполироваться значения измерений между калибровочными точками.

  • BETWEENЗначения измерений будут интерполироваться между калибровочными точками. Это значение по умолчанию
  • NO_BETWEENЗначения измерений не будут интерполироваться между калибровочными точками.
Boolean
extrapolate_before
(Дополнительный)

Определяет, будут ли экстраполироваться значения перед калибровочными точками.

  • BEFOREЗначения измерений будут экстраполироваться перед калибровочными точками. Это значение по умолчанию
  • NO_BEFOREЗначения измерений не будут экстраполироваться перед калибровочными точками.
Boolean
extrapolate_after
(Дополнительный)

Определяет, будут ли экстраполироваться значения после калибровочных точек.

  • AFTERЗначения измерений будут экстраполироваться после калибровочных точек. Это значение по умолчанию
  • NO_AFTERЗначения измерений не будут экстраполироваться после калибровочных точек.
Boolean
ignore_gaps
(Дополнительный)

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

  • IGNOREПространственные разрывы будут проигнорированы. Для разорванных маршрутов измерения будут непрерывными. Это значение по умолчанию
  • NO_IGNOREПространственные разрывы будут проигнорированы. Значения измерений на разорванных маршрутах также будут иметь разрывы. Величина разрыва будет вычисляться как расстояние по прямой между конечными точками частей разорванного маршрута.
Boolean
keep_all_routes
(Дополнительный)

Определяет, будут ли объекты-маршруты, для которых отсутствуют калибровочные точки, включены в выходной класс объектов.

  • KEEPВсе объекты-маршруты будут включены в выходной класс объектов. Это значение по умолчанию
  • NO_KEEPВсе объекты-маршруты не будут обязательно включены в выходной класс объектов. Объекты, для которых отсутствуют калибровочные точки, будут исключены.
Boolean
build_index
(Дополнительный)

Определяет, будет ли создан атрибутивный индекс для поля идентификатора маршрутов, которое записывается в значение параметра out_feature_class.

  • INDEXБудет создан атрибутивный индекс. Это значение по умолчанию
  • NO_INDEXНе будет создан атрибутивный индекс.
Boolean

Пример кода

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

В следующем скрипте окна Python показано, как используется функция CalibrateRoutes в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.lr.CalibrateRoutes("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE", 
                         "C:/output/hwy_new.shp","DISTANCE", "5.0 feet", 
                         "BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")
CalibrateRoutes, пример 2 (автономный скрипт)

Демонстрирует использование функции CalibrateRoutes с данными файловой базы геоданных в автономном скрипте Python.

# Name CalibrateRoutes_Example2.py
# Description: Calibrate personal geodatabase routes with file geodatabase 
# points.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
rts = "roads/hwy"  # hwy is in the roads feature dataset
rid = "ROUTE1" 
pts = "roads/cal_pts"  # cal_pts is in the roads feature dataset
mfield = "MEASURE"
radius = "2.5 Meters"
out_fc = "roads/hwy_new"  # new feature class in the roads feature dataset

# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "BETWEEN", "NO_BEFORE", "NO_AFTER")
CalibrateRoutes, пример 3 (автономный скрипт)

Демонстрирует использование функции CalibrateRoutes с данными многопользовательской базы геоданных в автономном скрипте Python.

# Name CalibrateRoutes_Example3.py
# Description: Calibrate enterprise geodatabase routes using enterprise 
# geodatabase points.

# Import system modules
import arcpy

# Set workspace
wkspc = "C:/MyProject/myConn.sde"
arcpy.env.workspace = wkspc 

# Set local variables
rts = arcpy.ValidateTableName("hwy", wkspc)  # standalone feature class
rid = "ROUTE1"
pts = arcpy.ValidateTableName("cal_pts", wkspc)  # standalone feature class
mfield = "MEASURE"
radius = "5.0 Feet"
out_fc = "hwy_new" # new standalone feature class 

# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "#", "#", "#", "#", "NO_KEEP")

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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