Update Calibration Points (Roads and Highways)

Récapitulatif

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

Utilisation

• 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.

Syntaxe

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})

Paramètre	Explication	Type de données
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 (Facultatif)	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 (Facultatif)	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 (Facultatif)	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 (Facultatif)	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 (Facultatif)	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

Exemple de code

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

Environnements

Cet outil n'utilise aucun environnement de géotraitement

Informations de licence

ArcGIS for Desktop Basic: Requis Roads and Highways

ArcGIS for Desktop Standard: Requis Roads and Highways

ArcGIS for Desktop Advanced: Requis Roads and Highways