ArcMap

Калибровка маршрута

Сводка

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

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

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

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

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

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

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

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

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

  • Если какие-либо пространственные объекты обрабатываются с помощью процесса Калибровка маршрутов (Calibrate Routes), создается временный текстовый файл для хранения информации об этих объектах. Например, C:\Documents and Settings\patrickb\Local Settings\Temp\Calibrate_Output0.txt (где Calibrate_Output – имя Выходного класса объектов-маршрутов (Output Route Feature Class)).

Синтаксис

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
(Дополнительный)

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

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
(Дополнительный)

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

  • INDEX —Создается атрибутивный индекс. Это значение используется по умолчанию.
  • NO_INDEX —Атрибутивный индекс не создается.
Boolean

Пример кода

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

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

import arcpy
from arcpy import env

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 (автономный скрипт Python)

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

# Name CalibrateRoutes_Example2.py
# Description: Calibrate personal geodatabase routes with file geodatabase points.
 
# Import system modules
import arcpy
from arcpy import env

# Set workspace
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 (автономный скрипт Python)

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

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

# Import system modules
import arcpy
from arcpy import env

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

# 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 a feature dataset

# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
                           "BETWEEN", "NO_BEFORE", "NO_AFTER")
Пример №4 инструмента CalibrateRoutes (автономный скрипт Python)

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

# Name Example 4:
# Description: Calibrate enterprise geodatabase routes using enterprise geodatabase points.

# Import system modules
import arcpy
from arcpy import env

# Set workspace
wkspc = "Database Connections/Connection to Jerry.sde"
env.workspace = wkspc 

# Set local variables
rts = gp.QualifyTableName("hwy", wkspc)      # standalone feature class
rid = "ROUTE1"
pts = gp.QualifyTableName("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: Да

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