Calculate ATS Route Attributes (Aviation)

Available with Aviation Charting license.

Summary

Calculates segment distance and bearing attributes on Air Traffic Service (ATS) route features.

This tool calculates the magnetic track and reverse magnetic track based on the magnetic variation at the endpoints of routes.

Usage

• The Input ATS Route Feature Layer parameter value must be a polyline.

• If the ATS Route Attributes parameter is set to Magnetic Track or Reverse Magnetic Track, the Magnetic Variation Date parameter must be specified.

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• One or more of the following attributes can be specified for calculation. Calculated attributes will be written to the selected numeric fields in the Input ATS Route Feature Layer parameter value.

  • Length—The length of the route segment in nautical miles will be calculated.
  • True Track—The True North azimuth of the route segment's track from its start point will be calculated.
  • Reverse True Track—The True North azimuth of the route segment's reverse track from its end point will be calculated.
  • Magnetic Track—The Magnetic North azimuth of the route segment's track from its start point will be calculated.
  • Reverse Magnetic Track—The Magnetic North azimuth of the route segment's reverse track from its end point will be calculated.

• The ATSRoute feature class in the AIS Charting data model can be used for the Input ATS Route Feature Layer parameter value. It contains the following fields that can be used as input fields: LENGTH_VAL, TRUETRACK_VAL, REVERSETRUETRACK_VAL, MAGTRACK_VAL, and REVERSEMAGTRACK_VAL.

Parameters

Dialog

Label	Explanation	Data Type
Input ATS Route Feature Layer	The polyline features for which ATS route attributes will be calculated.	Feature Layer
ATS Route Attributes	Specifies the ATS route attributes that will be calculated. Length—The length of the route segment in nautical miles will be calculated. True Track—The True North azimuth of the route segment's track from its start point will be calculated. Reverse True Track—The True North azimuth of the route segment's reverse track from its end point will be calculated. Magnetic Track—The Magnetic North azimuth of the route segment's track from its start point will be calculated. Reverse Magnetic Track—The Magnetic North azimuth of the route segment's reverse track from its end point will be calculated.	Value Table
Magnetic Variation Date (Optional)	The date for which the magnetic field values will be calculated.	Date

Derived Output

Label	Explanation	Data Type
Updated Features	The input ATS route feature layer with the updated fields.	Feature Layer

Python

arcpy.aviation.CalculateATSRouteAttributes(in_features, atsroute_attributes, {magnetic_variation_date})

Name	Explanation	Data Type
in_features	The polyline features for which ATS route attributes will be calculated.	Feature Layer
atsroute_attributes [atsroute_attributes,...]	Specifies the ATS route attributes that will be calculated. LENGTH—The length of the route segment in nautical miles will be calculated. TRUE_TRACK—The True North azimuth of the route segment's track from its start point will be calculated. REVERSE_TRUE_TRACK—The True North azimuth of the route segment's reverse track from its end point will be calculated. MAG_TRACK—The Magnetic North azimuth of the route segment's track from its start point will be calculated. REVERSE_MAG_TRACK—The Magnetic North azimuth of the route segment's reverse track from its end point will be calculated.	Value Table
magnetic_variation_date (Optional)	The date for which the magnetic field values will be calculated.	Date

Derived Output

Name	Explanation	Data Type
updated_features	The input ATS route feature layer with the updated fields.	Feature Layer

Code sample

CalculateATSRouteAttributes example (stand-alone script)

The following script demonstrates how to use the CalculateATSRouteAttributes function.

import arcpy

# Check Out Aeronautical Extension
arcpy.CheckOutExtension("Aeronautical")

#Input ATS Route Feature Layer
in_features = r"C:\data\AIS.gdb\ATSRoutes"

#Add fields in the in_features if not exist already
arcpy.AddField_management(in_features, 'Length', 'DOUBLE')
arcpy.AddField_management(in_features, 'TRUETRACK_VAL', 'DOUBLE')
arcpy.AddField_management(in_features, 'REVERSETRUETRACK_VAL', 'DOUBLE')
arcpy.AddField_management(in_features, 'MAGTRACK_VAL', 'DOUBLE')
arcpy.AddField_management(in_features, 'REVERSE_MAG_TRACK', 'DOUBLE')

#Input ATS Route Attributes to be calculated
atsroute_attributes= "LENGTH Length;TRUE_TRACK TRUETRACK_VAL;REVERSE_TRUE_TRACK REVERSETRUETRACK_VAL;MAG_TRACK MAGTRACK_VAL;REVERSE_MAG_TRACK REVERSEMAGTRACK_VAL"

#Input Magnetic Variation Date
magnetic_variation="12/31/2021 10:52:18 AM"

# Exceute Calculate ATSRoute Attributes
arcpy.aviation.CalculateATSRouteAttributes(in_features, atsroute_attributes, magnetic_variation)

# Check In Aeronautical Extension
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