校准路径 (线性参考)

摘要

使用点重新计算路径测量值。

使用情况

  • 可以校准全部或部分路径。可以选择在输入点之间采用内插法、在输入点之前采用外推法、在输入点之后采用外推法或使用这三种方法的任意组合。

  • 创建要素图层创建查询表用于有效降低要校准的路径数。

  • 如果输出路径要素类将写入地理数据库,则应设置相应的 M 容差M 分辨率M 属性域环境。

  • 输出路径要素类包括输入路径要素中的所有字段。

  • outputMFlag 环境设置将被忽略。输出路径要素类将有 m(测量)值。

  • 不能指定无穷大的搜索半径。

  • 路径标识符字段上的属性索引可加快动态分段过程的速度。如果要为动态分段使用输出路径要素类,建议您选择创建属性索引。

  • 若有任何要素被校准路径过程拒绝,则在临时文件路径下创建一个文本文件以存储有关这些要素的信息,例如 C:\Users\patrickb\AppData\Local\Temp\Calibrate_Output0.txt(其中,Calibrate_Output 是输出路径要素类的名称)。

参数

标注说明数据类型
输入路径要素

要校准的路径要素。

Feature Layer
路径标识符字段

包含可唯一识别每条路径的值的字段。该字段可以是数值或字符。

Field
输入点要素

用于校准路径的点要素。

Feature Layer
点标识符字段

标识包含每个校准点所在的路径的字段。该字段中的值与路径标识符字段中的值相匹配。该字段可以是数值或字符。

Field
测量字段

包含每个校准点的测量值的字段。该字段必须为数值型。

Field
输出路径要素类

待创建的要素类。它可以是 shapefile,也可以是地理数据库要素类。

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

待创建的要素类。它可以是 shapefile,也可以是地理数据库要素类。

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(独立脚本)

以下 Python 脚本演示了如何在 Python 独立脚本中将 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(独立脚本)

以下 Python 脚本演示了如何在 Python 独立脚本中将 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: 是

相关主题