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

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

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

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

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

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

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

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

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

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

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

  • Если какие-либо пространственные объекты обрабатываются с помощью процесса Калибровка маршрутов, создается временный текстовый файл для хранения информации об этих объектах, например 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.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: Да

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