Generate Calibration Points (Roads and Highways)

ライセンス レベル:BasicStandardAdvanced

サマリ

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

使用法

構文

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})
パラメータ説明データ タイプ
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_2DMeasure values on input route feature (PolylineM)
  • M_ON_ROUTE_3DMeasure values on input route feature (PolylineMZ)
  • GEOMETRY_LENGTH_2DShape length of input route feature (PolylineM)
  • GEOMETRY_LENGTH_3DShape length of input route feature (PolylineMZ)
  • ATTRIBUTE_FIELDS_2DMeasure values stored in attribute fields of input route feature (PolylineM)
  • ATTRIBUTE_FIELDS_3DMeasure 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
(オプション)

The field containing the From Date values of a route.

Field
in_to_date_field
(オプション)

The field containing the To Date values of a route.

Field
in_from_measure_field
(オプション)

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
(オプション)

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
(オプション)

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. 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
(オプション)

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
(オプション)

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_DIRECTIONFollows the direction of digitization on the input route features. This is the default.
  • MEASURE_DIRECTIONFollows 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
(オプション)

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_INCREMENTAdds a step to the calibration of physically gapped routes. This is the default.
  • ADDING_INCREMENTAdds an increment to the gap and total length of physically gapped routes.
  • ADDING_EUCLIDEAN_DISTANCEAdds Euclidean distance to the calibration of physically gapped routes.
String
in_gap_measure_increment
(オプション)

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
(オプション)

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

コードのサンプル

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

環境

このツールはジオプロセシング環境を使用していません

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Roads and Highways
ArcGIS for Desktop Standard: 次のものが必要 Roads and Highways
ArcGIS for Desktop Advanced: 次のものが必要 Roads and Highways
5/9/2014