ArcGIS Help 10.2 - Update Calibration Points (Roads and Highways)

Summary

Builds calibration point features when an advanced linear referencing system already exists in the geodatabase.

Usage

Input Polyline Features is used as a source linear referencing method for calculating the measure values to update the calibration point feature class.
The Measure Tolerance parameter is only used when you choose to update measures on existing calibration points.
If the existing measure lies within the tolerance of the calculated measure, the measure on the calibration point will not be updated.

Syntax

UpdateCalibrationPoints_roads (in_polyline_features, in_routeid_field, in_calibration_point_features, in_lrs, in_network, in_calculation_method, in_update_method, in_search_tolerance, in_measure_tolerance, {in_from_measure_field}, {in_to_measure_field}, in_source_unit_of_measure, {in_calibration_direction}, {in_gap_calibration_type}, {in_gap_measure_increment})

Parameter	Explanation	Data Type
in_polyline_features	The Input Polyline Features that will be used as the source to calculate the measures values for the calibration points.	Feature Layer
in_routeid_field	The field containing values that uniquely identify each route. Long, Short, Text, GUID, and GlobalID field types are supported.	Field
in_calibration_point_features	The calibration point feature class in which new features will be added and existing features will be updated.	Feature Layer
in_lrs	The advanced linear referencing system with which the calibration point feature class is associated.	String
in_network	The LRS Network layer for which the measure values need to be generated/updated in the calibration points feature class.	String
in_calculation_method	The method used to calculate measure value for calibration points being updated. M_ON_ROUTE_2D —Measure values on input route feature (PolylineM) M_ON_ROUTE_3D —Measure values on input route feature (PolylineMZ) GEOMETRY_LENGTH_2D —Shape length of input route feature (PolylineM) GEOMETRY_LENGTH_3D —Shape length of input route feature (PolylineMZ) ATTRIBUTE_FIELDS_2D —Measure values stored in attribute fields of input route feature (PolylineM) ATTRIBUTE_FIELDS_3D —Measure values stored in attribute fields of input route feature (PolylineMZ) INTERPOLATE_EXISTING —Measures on existing calibration points are used to interpolate new measure values	String
in_update_method	This method determines which calibration point features get updated. UPDATE_NONE —None of the existing calibration points gets updated but creates new calibration point features as required for a correct calibration of the route. UPDATE_END_CALIBRATION_POINTS_ONLY —Update all existing calibration points at the end of the contiguous part of the route. UPDATE_ALL_EXISTING_CALIBRATION_POINTS — Update all existing calibration points along the route.	String
in_search_tolerance	New calibration points will not be created at the end point of a route if another calibration point already exists within the Search Tolerance.	Double
in_measure_tolerance	All existing calibration points that fall within this measure tolerance will not have its measure values updated.	Double
in_from_measure_field (Optional)	The field containing the From Measure of a route. This parameter becomes active if the Calculation Method parameter is set to ATTRIBUTE_FIELDS_2D or ATTRIBUTE_FIELDS_3D.	Field
in_to_measure_field (Optional)	The field containing the To Measure of a route. This parameter becomes active if the Calculation Method parameter is set to ATTRIBUTE_FIELDS_2D or ATTRIBUTE_FIELDS_3D.	Field
in_source_unit_of_measure	The source unit of measure of the input polyline features. This parameter becomes active if the Calculation Method parameter is set to M_ON_ROUTE_2D or M_ON_ROUTE_3D.	String
in_calibration_direction (Optional)	Determines the direction of calibration for calibration points based on the input route features. This parameter becomes active if the Calculation Method parameter is set to GEOMETRY_LENGTH_2D or GEOMETRY_LENGTH_3D. DIGITIZED_DIRECTION —Follows the direction of digitization on the input route features. This is the default. MEASURE_DIRECTION —Follows the increasing measure values on the input route features. Should only be selected if input route features have measure values.	String
in_gap_calibration_type (Optional)	Determines the method for calibrating physically gapped routes based on the input route features. This parameter becomes active if the Calculation Method parameter is set to GEOMETRY_LENGTH_2D or GEOMETRY_LENGTH_3D. STEPPING_INCREMENT —Adds a step to the calibration of physically gapped routes. This is the default. ADDING_INCREMENT —Adds an increment to the gap and total length of physically gapped routes. ADDING_EUCLIDEAN_DISTANCE —Adds Euclidean distance to the calibration of physically gapped routes.	String
in_gap_measure_increment (Optional)	Determines the value that is added to the calibration of the endpoints of a physically gapped route. This parameter is required if the Gap Calibration Type parameter is set to STEPPING_INCREMENT or ADDING_INCREMENT.	Long

Code Sample

UpdateCalibrationPoints example (Python window)

The following Python window script demonstrates how to use the UpdateCalibrationPoints function in immediate mode.

# tool variables
in_polyline_features="network"
in_routeid_field="ROUTE_ID"
in_calibration_point_features="Calibration_Point"
in_lrs="NY_ALRS"
in_network="MilePoint"
in_calculation_method="M_ON_ROUTE_2D"
in_update_method="UPDATE_ALL_EXISTING_CALIBRATION_POINTS"
in_search_tolerance="0.0001"
in_measure_tolerance="0.0001"
in_source_unit_of_measure="Miles"

# set current workspace
arcpy.env.workspace="C:/Data/NYData.gdb"

# execute the tool
arcpy.GenerateCalibrationPoints_roads("network", "ROUTE_ID", "Calibration_Point", "NY_ALRS", "MilePoint", "M_ON_ROUTE_2D", "UPDATE_ALL_EXISTING_CALIBRATION_POINTS", "0.0001", "0.0001", "", "", "Miles", "", "", "")

UpdateCalibrationPoints example (stand-alone mode)

The following Python window script demonstrates how to use the UpdateCalibrationPoints function in stand-alone mode.

# Name: GenerateCalibrationPoints.py
# Description: Update the existing calibration points feature class using the polylineMZ as input. 
# Requires: Esri Roads and Highways Solution

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("Highways")

# Local variables
network = "C:/Data/NYData.gdb/LRSN_MilePoint"
calibration_point = "C:/Data/NYData.gdb/Calibration_Point"

# Process: Make Feature Layer
arcpy.MakeFeatureLayer_management(network, "network_lyr")
arcpy.MakeFeatureLayer_management(calibration_point, "calibration_point_lyr")

# Process: Update Calibration Points
arcpy.GenerateCalibrationPoints_roads("network_lyr", "ROUTE_ID", "calibration_point_lyr", "NY_ALRS", "MilePoint", "GEOMETRY_LENGTH_3D", "UPDATE_END_CALIBRATION_POINTS_ONLY", "0.0001", "0.0001", "", "", "", "MEASURE_DIRECTION", "ADDING_INCREMENT", "0.01")

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcGIS for Desktop Basic: Requires Roads and Highways

ArcGIS for Desktop Standard: Requires Roads and Highways

ArcGIS for Desktop Advanced: Requires Roads and Highways

9/8/2014