Generate Calibration Points

Summary

Assists in the generation of calibration point features when there is no advanced linear referencing present in the geodatabase.

Usage

• Input Route Features is a polyline feature class used as a source linear referencing method for calculating the measure values for the calibration points.

• Output calibration points will be located at the ends of each part of a multipart polyline.

Syntax

GenerateCalibrationPoints_roads (in_polyline_features, in_routeid_field, in_calculation_method, out_calibration_point_features, {in_from_date_field}, {in_to_date_field}, {in_from_measure_field}, {in_to_measure_field}, {in_source_unit_of_measure}, {in_target_unit_of_measure}, {in_calibration_direction}, {in_gap_calibration_type}, {in_gap_measure_increment}, {in_gap_precision})

Parameter	Explanation	Data Type
in_polyline_features	The features from which measures will be calculated.	Feature Layer
in_routeid_field	The field containing values that uniquely identify each route. Fields of type Long, Short, Text, GUID, and GlobalID are supported.	Field
in_calculation_method	The method used to calculate the measure value for calibration points being generated. 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)	String
out_calibration_point_features	The feature class to which new features will be added and existing features will be updated.	Feature Class
in_from_date_field (Optional)	The field containing the From Date values of a route.	Field
in_to_date_field (Optional)	The field containing the To Date values of a route.	Field
in_from_measure_field (Optional)	The field containing the From Measure values 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 values 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 (Optional)	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_2Dor M_ON_ROUTE_3D. Source and Target Unit of Measure should match unless you wish to change the unit of measure of the M values in the input polyline features to a different unit of measure in your LRS Network.	String
in_target_unit_of_measure (Optional)	Calculates the measure values based on the units of measure from the spatial reference of the Input Route Features feature class. Use this parameter to generate the calibration point features with other units of measure for M values. Target Unit of Measure should match the unit of measure for the LRS Network.	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_2Dor 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_2Dor 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. The default value for the parameter is 0.	Long
in_gap_precision (Optional)	Determines how many decimal places to use when calculating the Euclidean distance between polyline segments in the input route features. This parameter is required if the Add Euclidean distance to physical gaps in routes parameter is selected. The default value for the parameter is 3.	Long

Code sample

GenerateCalibrationPoints example 1 (stand-alone Python script)

The following script demonstrates how to use GenerateCalibrationPoints using a stand-alone Python script.

# Name: GenerateCalibrationPoints.py
# Description: Generate the calibration point 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: Generate Calibration Points
arcpy.GenerateCalibrationPoints_roads(network, "ROUTE_ID", "M_ON_ROUTE_3D", calibration_point, "FROM_DATE", "TO_DATE", "", "", "Meters", "Miles", "", "", "", "")

GenerateCalibrationPoints example 2 (inline Python script)

The following inline script demonstrates how to use GenerateCalibrationPoints.

# tool variables
in_polyline_features="network"
in_routeid_field="Route_ID"
in_calculation_method="GEOMETRY_LENGTH_2D"
out_calibration_point_features="calibration_points"
in_from_date_field="FROM_DATE"
in_to_date_field="TO_DATE"
in_target_unit_of_measure="Miles"
in_calibration_direction="MEASURE_DIRECTION"
in_gap_calibration_type="ADDING_INCREMENT"
in_gap_measure_increment="0.1"

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

# execute the tool
arcpy.GenerateCalibrationPoints_roads("network", "ROUTE_ID", "GEOMETRY_LENGTH_2D", "calibration_points", "FROM_DATE", "TO_DATE", "", "", "", "Miles", "MEASURE_DIRECTION", "ADDING_INCREMENT", "0.1", "")

Environments

This tool does not use any geoprocessing environments