校准路径 (线性参考)

摘要

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

使用情况

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

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

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

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

  • 输出包含 M 值环境设置已忽略。 输出路径要素类将有 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: 是

相关主题