| 标注 | 说明 | 数据类型 |
输入路径要素 | 要校准的路径要素。 | Feature Layer |
路径标识符字段 | 包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。 | Field |
输入点要素 | 将用于校准路径的点要素。 | Feature Layer |
点标识符字段 | 标识包含每个校准点所在的路径的字段。 该字段中的值与路径标识符字段中的值相匹配。 此字段可以是数值、文本或 GUID 字段。 | Field |
测量字段 | 包含每个校准点的测量值的字段。 字段必须为数值。 | Field |
输出路径要素类 | 将要创建的要素类。 可以是 shapefile 或地理数据库要素类。 | Feature Class |
测量计算方法 (可选) | 指定如何重新计算路径测量值。
| String |
搜索半径 (可选) | 通过指定距离及其测量单位来限制校准点与路径的最大距离。 如果测量单位是“未知”，则使用路径要素类的坐标系单位。 | Linear Unit |
在校准点之间执行内插 (可选) | 指定是否在校准点之间插入测量值。
| Boolean |
在校准点之前执行外推 (可选) | 指定是否在校准点之前外推测量值。
| Boolean |
在校准点之后执行外推。 (可选) | 指定是否在校准点之后外推测量值。
| Boolean |
忽略空间间距 (可选) | 指定在重新计算不相交路径上的测量值时是否忽略空间间距。
| Boolean |
在输出要素类中包括所有要素 (可选) | 指定是否将在输出要素类中包含其中不含校准点的路径要素。
| Boolean |
构建索引 (可选) | 指定是否为写入输出路径要素类参数值的路径标识符字段创建属性索引。
| Boolean |
摘要
使用点重新计算路径测量值。
使用情况
可以校准全部或部分路径。 您可以在输入点之间执行内插、在输入点之前执行外推、在输入点之后执行外推，或者使用这些方法的任意组合。
输出路径要素类参数值将包括输入路径要素参数值的所有字段。
输出包含 M 值环境设置已忽略。 输出路径要素类参数值将包含 m 值（测量值）。
无法将搜索半径指定为无穷大。
路径标识符字段上的属性索引可加快动态分段过程的速度。 如果将使用输出路径要素类参数值进行动态分段，建议创建属性索引。
若有任何要素被此工具拒绝，则在临时文件路径下创建一个文本文件以存储有关这些要素的信息，例如 C:\Users\patrickb\AppData\Local\Temp\Calibrate_Output0.txt（其中，Calibrate_Output 是输出路径要素类参数值的名称）。
参数
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 | 包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。 | Field |
in_point_features | 将用于校准路径的点要素。 | Feature Layer |
point_id_field | 标识包含每个校准点所在的路径的字段。 该字段中的值与路径标识符字段中的值相匹配。 此字段可以是数值、文本或 GUID 字段。 | Field |
measure_field | 包含每个校准点的测量值的字段。 字段必须为数值。 | Field |
out_feature_class | 将要创建的要素类。 可以是 shapefile 或地理数据库要素类。 | Feature Class |
calibrate_method (可选) | 指定如何重新计算路径测量值。
| String |
search_radius (可选) | 通过指定距离及其测量单位来限制校准点与路径的最大距离。 如果测量单位是“未知”，则使用路径要素类的坐标系单位。 | Linear Unit |
interpolate_between (可选) | 指定是否在校准点之间插入测量值。
| Boolean |
extrapolate_before (可选) | 指定是否在校准点之前外推测量值。
| Boolean |
extrapolate_after (可选) | 指定是否在校准点之后外推测量值。
| Boolean |
ignore_gaps (可选) | 指定在重新计算不相交路径上的测量值时是否忽略空间间距。
| Boolean |
keep_all_routes (可选) | 指定是否将在输出要素类中包含其中不含校准点的路径要素。
| Boolean |
build_index (可选) | 指定是否为写入 out_feature_class 参数值的路径标识符字段创建属性索引。
| Boolean |
代码示例
以下 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")以下 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
# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
"BETWEEN", "NO_BEFORE", "NO_AFTER")以下 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
# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
"#", "#", "#", "#", "NO_KEEP")许可信息
- Basic: 是
- Standard: 是
- Advanced: 是