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

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

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

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

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

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

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

  • Выходной класс объектов-маршрутов будет содержать все поля из Входных объектов-маршрутов .

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

Field
in_point_features

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

Feature Layer
point_id_field

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

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.CalibrateRoutes_lr("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 с данными файловой базы геоданных.

# 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
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "BETWEEN", "NO_BEFORE", "NO_AFTER")
CalibrateRoutes, пример 3 (автономный скрипт)

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

# 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 
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "#", "#", "#", "#", "NO_KEEP")

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

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

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