Modify Network Calibration Rules (Location Referencing)

Краткая информация

Modifies the network calibration rules for an LRS Network.

When creating an LRS Network, you can choose how gapped routes are calibrated while creating or editing routes. Using this tool, you can configure calibration rules for a network after the LRS Network has been created and during the data loading process.

Learn more about creating and modifying an LRS Network in ArcGIS Pipeline Referencing or creating and modifying an LRS Network in ArcGIS Roads and Highways.

You can use any of the following methods to calibrate routes with physical gaps:

  • Stepping Increment
  • Adding Increment
  • Euclidean Distance

Each method will produce a different calibration value for a route with physical gaps created using the LRS editing tools. The example below shows the calibration of a route created from a centerline with physical gaps for each calibration method and calibration of a route with retirement between the measure 0.5 and 1 for each calibration method.

In the retire route scenario, a physical gap is created between the measures 0.5 and 1. The calibration rules are applied only if a physical gap is introduced due to an editing activity and do not affect the existing gaps. In the example, the gap between measures 2 and 2.5 remains unaffected due to retirement.

Использование

  • The following tables show the results of gap calibration using the Create Route and Retire Route panes after setting up rules using this tool.

    Построение маршрутов с реальными промежутками

    Построение маршрутаПример калибровкиОписание

    Пошаговое приращение 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 добавляется к каждому измерению после реального промежутка, возникшего в связи с исключением.

    Евклидово расстояние

    Евклидово расстояние

    Значение измерения, равное прямолинейному расстоянию реального промежутка, добавляется к первому измерению после реального промежутка, введенного из-за исключения.

    Легенда
  • This tool supports setting the gap calibration rule and the calibration offset for the specified network.

  • Typically, network calibration rules can be modified once the network is created. Changing the calibration rule will apply the new rule only to routes edited or loaded in the future. All routes edited or loaded previously will not honor the new calibration rule. They honor the calibration rule set at the time of their creation or editing.

  • You can use the As Is option in the Calibration Rule parameter to retain the existing gap calibration method with an option to change only the calibration offset value pursuant to requirement.

  • The Calibration Offset parameter must be set for the adding increment and stepping increment methods. The values must be numeric, with or without decimals; negative values cannot be used.

  • The Calibration Offset parameter value cannot be set less than or equal to the m-tolerance of the network. It can be either zero or greater than the m-tolerance value of the network.

  • Defining the Calibration Offset parameter value as zero (0) will produce a route with no gap in calibration measure at physical gaps.

  • The default gap calibration rule for an LRS Network is Stepping Increment with an offset value of 0.

  • This tool is not supported with feature services.

Параметры

ПодписьОписаниеТип данных
LRS Network Feature Class

The input LRS Network feature class.

Feature Layer
Calibration Rule
(Дополнительный)

Specifies the method that will be used to define calibration gap measures.

  • As IsThe existing defined method in the network will be used while changing the calibration offset value.
  • Adding Euclidean DistanceThe Euclidean, or straight-line, distance will be calculated and added at each physical gap along an edited route.
  • Stepping IncrementA value will be defined that will adjust, or step, at each physical gap in the route. This is the default.
  • Adding Increment A value will be defined and added to each measure of a route at each physical gap, in addition to the total length of the from and to measures of the route.
String
Calibration Offset
(Дополнительный)

The value of the Calibration Rule parameter's Adding Increment or Stepping Increment method. The increment value must be numeric and can include decimals.

Double
Update route measures in cartographic realignment
(Дополнительный)

Specifies whether or not to recalibrate route measures based on length changes in cartographic realignment.

  • As isThe existing defined method in the network will be used. This is the default.
  • EnableEnable recalibration of route measures based on length changes in cartographic realignment.
  • DisableDisable recalibration of route measures based on length changes in cartographic realignment.
String

Производные выходные данные

ПодписьОписаниеТип данных
Output Network Feature Class

The updated network feature layer.

Feature Layer

arcpy.locref.ModifyNetworkCalibrationRules(in_feature_class, {calibration_rule}, {calibration_offset}, {update_measure_cartorealign})
ИмяОписаниеТип данных
in_feature_class

The input LRS Network feature class.

Feature Layer
calibration_rule
(Дополнительный)

Specifies the method that will be used to define calibration gap measures.

  • AS_ISThe existing defined method in the network will be used while changing the calibration offset value.
  • ADDING_EUCLIDEAN_DISTANCEThe Euclidean, or straight-line, distance will be calculated and added at each physical gap along an edited route.
  • STEPPING_INCREMENTA value will be defined that will adjust, or step, at each physical gap in the route. This is the default.
  • ADDING_INCREMENT A value will be defined and added to each measure of a route at each physical gap, in addition to the total length of the from and to measures of the route.
String
calibration_offset
(Дополнительный)

The value of the Calibration Rule parameter's Adding Increment or Stepping Increment method. The increment value must be numeric and can include decimals.

Double
update_measure_cartorealign
(Дополнительный)

Specifies whether or not to recalibrate route measures based on length changes in cartographic realignment.

  • AS_ISThe existing defined method in the network will be used. This is the default.
  • ENABLEEnable recalibration of route measures based on length changes in cartographic realignment.
  • DISABLEDisable recalibration of route measures based on length changes in cartographic realignment.
String

Производные выходные данные

ИмяОписаниеТип данных
out_feature_class

The updated network feature layer.

Feature Layer

Пример кода

ModifyNetworkCalibrationRules example 1 (Python window)

The following script demonstrates how to use the ModifyNetworkCalibrationRules function in the Python window.

#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 example 2 (stand-alone script)

The following script demonstrates how to use the ModifyNetworkCalibrationRules function as a stand-alone Python script.

#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

Связанные разделы