修改网络校准规则 (位置参考)

摘要

修改 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.5 和 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

#Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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"

# Execute the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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

#Check out license
arcpy.CheckOutExtension("LocationReferencing")

# 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"

# Execute the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

许可信息

  • Basic: 需要 ArcGIS Location Referencing
  • Standard: 需要 ArcGIS Location Referencing
  • Advanced: 需要 ArcGIS Location Referencing

相关主题