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

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

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

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

Можно калибровать как маршруты целиком, так и их части. Вы можете выполнить интерполяцию между входными точками, экстраполяцию до входных точек, экстраполяцию после входных точек, или использовать любую комбинацию из этих методов.
Используйте инструмент Создать векторный слой или Создать таблицу запроса, чтобы значительно сократить маршруты, которые будут подвергнуты калибровке.
Если Выходной класс объектов-маршрутов будет записан в базу геоданных, задайте соответствующие параметры среды Допуск 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")

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

Текущая рабочая область, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Выходная система координат, Экстент, Выходные данные содержат Z значения, Временная рабочая область

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