Generate Changeover Points (Aviation)

Available with Aviation Charting license.

Summary

Creates changeover points along routes.

This tool creates changeover point features, deriving the point's location from a changeover distance provided on the input features. It also calculates secondary attributes on the target changeover point features that support symbology and labeling on a chart.

Usage

• The Target Changeover Point Features parameter value must contain the following attributes: DISTANCE1_VAL (Double), DISTANCE2_VAL (Double), CARTOANGLE_VAL (Double), and ATSROUTE_ID (GUID).

• Specify a Distance Source Type parameter value that is appropriate for the data. The changeover distance for a route is often stored on the Input ATS Route Features parameter value but can be stored on the Target Changeover Point Features parameter value in some cases. This parameter identifies the input that contains the changeover distance value.

  • Choose the Route option for the Distance Source Type parameter if changeover distances are stored on a route segment feature in the ATSRoute or other line feature class. In this case, the changeover distance must be stored in an attribute named COPDIST_VAL (Double). The tool inserts new changeover points into the target point layer or updates existing changeover point features.
  • Choose the Point option for the Distance Source Type parameter if changeover distances are stored on a changeover point feature in the target point later. In this case, the changeover distance must be stored in an attribute named DISTANCE1_VAL (Double), and an attribute named ATSROUTE_ID (GUID) must be populated with the GFID value of the corresponding route feature. The tool updates the geometry and attributes of the changeover point features accordingly.

Parameters

Dialog

Label	Explanation	Data Type
Input ATS Route Features	The input feature class of routes on which changeover points are based. It must contain polyline features.	Feature Layer
Target Changeover Point Features	The point feature class that contains the changeover points. After running the tool, new changeover points are added and existing changeover points are updated.	Feature Layer
Distance Source Type	Specifies the source of the changeover distance value. Route—The changeover distances are stored in the source line layer. Point—The changeover distances are stored in the target point layer.	String

Derived Output

Label	Explanation	Data Type
Updated Point Features	The output features for changeover points.	Feature Layer

Python

arcpy.aviation.GenerateChangeoverPoints(in_features, target_changeover_features, distance_source_type)

Name	Explanation	Data Type
in_features	The input feature class of routes on which changeover points are based. It must contain polyline features.	Feature Layer
target_changeover_features	The point feature class that contains the changeover points. After running the tool, new changeover points are added and existing changeover points are updated.	Feature Layer
distance_source_type	Specifies the source of the changeover distance value. ROUTE—The changeover distances are stored in the source line layer. POINT—The changeover distances are stored in the target point layer.	String

Derived Output

Name	Explanation	Data Type
updated_features	The output features for changeover points.	Feature Layer

Code sample

GenerateChangeoverPoints example (stand-alone script)

The following script demonstrates how to use the GenerateChangeoverPoints function.

# Import system modules
import arcpy

# Check out extensions
arcpy.CheckOutExtension('Aeronautical')

# Set local variables
in_features = r"C:\data\AIS.gdb\ATSRoutes"
target_changeover_features = r"C:\data\AIS.gdb\ChangeOver"
distance_source = 'ROUTE'

# Call the GenerateChangeoverPoints tool 
arcpy.aviation.GenerateChangeoverPoints(in_features, target_changeover_features,\
                                        distance_source)

# Check in extensions
arcpy.CheckInExtension('Aeronautical')

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: No
• Standard: Requires ArcGIS Aviation Charting
• Advanced: Requires ArcGIS Aviation Charting