修改网络校准规则 (位置参考工具)
汇总
修改 LRS 网络的网络校准规则。
创建 LRS 网络时，您可以选择在创建或编辑路径时校准间距路径的方式。 使用此工具，您可以在 LRS 网络创建后和数据加载过程中为网络配置校准规则。
了解有关在 ArcGIS Pipeline Referencing 中创建和修改 LRS 网络或在 ArcGIS Roads and Highways 中创建和修改 LRS 网络的详细信息。
可以使用以下任一方法来校准具有物理间距的路径：
对于使用 LRS 编辑工具创建的具有物理间距的路径，每种方法都会生成不同的校准值。 以下示例显示了从中心线创建的路径的校准及各校准方法的物理间距，以及每种校准方法中停用测量值在 0.5 和 1 之间的路径的校准。
在停用路径场景中，在测量值 0.5 和 1 之间会产生物理间距。 仅当由于编辑活动而引入物理间隙且不影响现有间距时，才会应用校准规则。 在示例中，测量值 2 和 2.5 之间的间距不会因停用而受到影响。
用法
下表显示了在使用此工具设置规则后，使用创建路径和停用路径窗格进行间距校准的结果。
|
创建路径
|
示例校准
|
描述
|
|
步进增量 0.1
|
|
测量值 0.1 会添加至每个物理间隙后的第一个测量值。
|
|
添加增量 0.1
|
|
测量值 0.1 会添加至每个物理间隙后的每个测量值。
|
|
欧氏距离
|
|
等于物理间隙的直线距离的测量值将添加至每个物理间距后的第一个测量值。
|
|
|
|
停用路径
|
示例校准
|
描述
|
|
停用之前的路径会创建物理间隙
|
|
在使用停用工具创建物理间隙之前，显示的路径停用部分。
|
|
步进增量 0.1
|
|
测量值 0.1 会添加至物理间隙后的第一个测量值。
|
|
添加增量 0.1
|
|
测量值 0.1 会添加至因停用引入的物理间隙后的每个测量值。
|
|
欧氏距离
|
|
等于物理间隙的直线距离的测量值将添加至因停用引入的物理间隙后的第一个测量值。
|
|
|
该工具支持为指定网络设置间距校准规则和校准偏移量。
通常，创建网络后，即可修改网络校准规则。 更改校准规则仅会将新规则应用于将来编辑或加载的路径。 之前编辑或加载的所有路径都不会遵守新的校准规则。 它们将遵守在创建或编辑时设置的校准规则。
您可以使用校准规则参数中的保留原样选项来保留现有的间距校准方法，并选择根据要求仅更改校准偏移值。
必须为添加增量和步进增量方法设置校准偏移参数。 该值必须是数字，带或不带小数；但不能使用负值。
校准偏移参数值不能设置为小于或等于网络的 m 容差。 该值可以为零或大于网络的 m 容差值。
将校准偏移参数值定义为零 (0) 将生成在物理间距的校准测量中没有间距的路径。
LRS 网络的默认间距校准规则是步进增量，偏移值为 0。
要素服务不支持此工具。
参数
|
标注
|
说明
|
数据类型
|
|
LRS 网络要素类
|
输入 LRS 网络要素类。
|
Feature Layer
|
|
校准规则
（可选）
|
指定将用于定义校准间距测量值的方法。
保留原样—更改校准偏移值时将使用网络中现有定义的方法。
添加欧氏距离—将沿编辑路径在每个物理间距处计算并添加欧氏距离或直线距离。
步进增量—将定义一个值，用于在路径中的每个物理间距处进行调整或步进。 这是默认设置。
添加增量—除了路径起点和终点测量值间的总长度之外，还可以定义该值并将其添加到每个物理间距处每个路径测量值。
|
String
|
|
校准偏移
（可选）
|
校准规则参数中添加增量或步进增量方法的值。 增量值必须是数值并且可以包含小数。
|
Double
|
|
更新制图重新对齐中的路径测量
（可选）
|
指定是否根据制图重新对齐中的长度变化重新校准路径测量值。
保留原样—将使用网络中现有定义的方法。 这是默认设置。
启用—启用根据制图重新对齐中的长度变化重新校准路径测量值。
禁用—禁用根据制图重新对齐中的长度变化重新校准路径测量值。
|
String
|
派生输出
|
标注
|
说明
|
数据类型
|
|
输出网络要素类
|
更新的网络要素图层。
|
Feature Layer
|
arcpy.locref.ModifyNetworkCalibrationRules(in_feature_class, {calibration_rule}, {calibration_offset}, {update_measure_cartorealign})
|
名称
|
说明
|
数据类型
|
|
in_feature_class
|
输入 LRS 网络要素类。
|
Feature Layer
|
|
calibration_rule
（可选）
|
指定将用于定义校准间距测量值的方法。
AS_IS—更改校准偏移值时将使用网络中现有定义的方法。
ADDING_EUCLIDEAN_DISTANCE—将沿编辑路径在每个物理间距处计算并添加欧氏距离或直线距离。
STEPPING_INCREMENT—将定义一个值，用于在路径中的每个物理间距处进行调整或步进。 这是默认设置。
ADDING_INCREMENT—除了路径起点和终点测量值间的总长度之外，还可以定义该值并将其添加到每个物理间距处每个路径测量值。
|
String
|
|
calibration_offset
（可选）
|
校准规则参数中添加增量或步进增量方法的值。 增量值必须是数值并且可以包含小数。
|
Double
|
|
update_measure_cartorealign
（可选）
|
指定是否根据制图重新对齐中的长度变化重新校准路径测量值。
AS_IS—将使用网络中现有定义的方法。 这是默认设置。
ENABLE—启用根据制图重新对齐中的长度变化重新校准路径测量值。
DISABLE—禁用根据制图重新对齐中的长度变化重新校准路径测量值。
|
String
|
派生输出
|
名称
|
说明
|
数据类型
|
|
out_feature_class
|
更新的网络要素图层。
|
Feature Layer
|
代码示例
ModifyNetworkCalibrationRules 示例 1（Python 窗口）
以下脚本演示了如何在 Python 窗口中使用 ModifyNetworkCalibrationRules 函数。
#Name: ModifyNetworkCalibrationRules_ex1.py
#Description: Use the ModifyNetworkCalibrationRules geoprocessing tool in the Python window.
#Requires: ArcGIS Location Referencing
# Set current workspace
arcpy.env.workspace = "C:\\Data\\LRS\\RS.gdb"
# Tool variables
in_network_class = r"C:\Data\Lrs.gdb\LRS\LRSNetwork"
calibration_rule = "ADDING_INCREMENT"
calibration_offset = 0.1
recalibrate_route_measures_based_on_length_change_in_cartorealign = "ENABLE"
# Run the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)
ModifyNetworkCalibrationRules 示例 2（独立脚本）
以下脚本演示了如何将 ModifyNetworkCalibrationRules 函数用作独立 Python 脚本。
#Name: ModifyNetworkCalibrationRules_ex2.py
#Description: This script demonstrates how to use ModifyNetworkCalibrationRules geoprocessing tool in stand-alone Python script.
#Requires: ArcGIS Location Referencing license
#Import arcpy module
import arcpy
# Tool variables
in_network_class = r"C:\Data\Lrs.gdb\LRS\LRSNetwork"
calibration_rule = "ADDING_INCREMENT"
calibration_offset = 0.1
recalibrate_route_measures_based_on_length_change_in_cartorealign = "ENABLE"
# Run the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)
环境
当前工作空间
许可信息
- 基本: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
- 标准: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
- 高级: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）