Skip To Content

Generate Calibration Points

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Generates calibration points for any route shape provided, including complex shapes such as self-closing, self-intersecting, and branched routes.

Verwendung

  • An LRS dataset is required to run this tool. To create an LRS dataset, add the Calibration Point, Centerline, and Redline layers to a feature dataset, and then run the Modify LRS tool with the geodatabase as the input.

  • Input Polyline Features are the basis for the newly created calibration points.

  • Calibration Point Feature Class must be registered with the LRS.

  • LRS Network must be registered with the LRS.

  • Derived LRS Networks are not supported as the LRS Network.

  • Hinweis:

    Only 2D calculations are applied when generating calibration points using this tool.

Syntax

GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method})
ParameterErklärungDatentyp
in_polyline_features

The features that will be used as the source to calculate the measure values for calibration points.

Feature Layer
route_id_field

The field containing values that uniquely identify each route. The field type must match the Route ID field in the calibration point feature class.

Field
from_date_field

The field containing the From Date values of a route.

Field
to_date_field

The field containing the To Date values of a route.

Field
in_calibration_point_feature_class

The existing calibration point feature class to which new features will be added.

Feature Layer
lrs_network

The LRS Network for which the measure values will be generated in the calibration points feature class.

String
calibration_direction
(optional)

Specifies the direction of increasing calibration on a route when creating new calibration points.

  • DIGITIZED_DIRECTIONThe direction of digitization of the Input Polyline Features determines the direction of calibration for the route. This is the default.
  • MEASURE_DIRECTIONThe direction of increasing m-values of the Input Polyline Features determines the direction of calibration for the route. If Input Polyline Features does not include m-values, the digitized direction will be used instead.
String
calibration_method
(optional)

The method used to determine the measures on a route when creating new calibration points.

  • GEOMETRY_LENGTHOnly geometry length is supported as the calibration method.
String

Abgeleitete Ausgabe

NameErklärungDatentyp
out_calibration_point_feature_class

The updated calibration features.

Feature Layer
out_details_file

A text file that details changes made by the tool.

Text File

Codebeispiel

GenerateCalibrationPoints example 1 (Python window)

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

# Tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"

# Set current workspace
arcpy.env.workspace = "C:/Data/UPDM.gdb"

# Execute Generate Calibration Points
arcpy.GenerateCalibrationPoints_locref(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, 'MEASURE_DIRECTION', 'GEOMETRY_LENGTH')
GenerateCalibrationPoints example 2 (stand-alone script)

The following stand-alone script demonstrates how to use the GenerateCalibrationPoints function.

# Name: GenerateCalibrationPoints.py
# Description: Builds calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Pipeline Referencing

# Import arcpy module
import arcpy

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

# Local variables:
SourceRoutes = "C:\\Data\\SourceData.gdb\\SourceRoutes"
RouteID = "RouteID"
FromDate = "FromDate"
ToDate = "ToDate"
CalibrationPoint = "C:\\Data\\UPDM.gdb\\Calibration_Point"
Network = "EngineeringNetwork"

# Process: Generate Calibration Points
arcpy.GenerateCalibrationPoints_locref(SourceRoutes, RouteID, FromDate, ToDate, CalibrationPoint, Network, 'MEASURE_DIRECTION', 'GEOMETRY_LENGTH')

Umgebungen

Faktor für parallele Verarbeitung

The default value for this environment, if left blank, is 100%. Any absolute value for the environment is always clamped between 0 and the number of logical cores in that machine.

Lizenzinformationen

  • Basic: Erfordert ArcGIS Location Referencing
  • Standard: Erfordert ArcGIS Location Referencing
  • Advanced: Erfordert ArcGIS Location Referencing

Verwandte Themen