Calculate ATS Route Attributes (Aviation)

Available with Aviation Charting license.

Summary

Calculates segment distance and bearing attributes on Air Traffic Service (ATS) route features. The tool can also calculate the FAA specific route attributes on a route segment and route collection.

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.

• One or more of the following FAA specific route attributes can be specified for calculation if the Input ATS Route feature layer contains the FAA specific attributes: TRUETRACK2_VAL, REVERSETRUERACK2_VAL, MAGTRACK2_VAL, REVERSEMAGTRACK2_VAL, or TFLAG_CODE. Calculated attributes will be written to the selected numeric fields in the Input ATS Route Feature Layer parameter value.

  • FAA True Track—The true north azimuth of the route segment's track from its start point will be calculated using FAA specific rules.
  • FAA Reverse True Track—The true north azimuth of the route segment's reverse track from its end point will be calculated using FAA specific rules.
  • FAA Magnetic Track—The magnetic north azimuth of the route segment's track from its start point will be calculated using FAA specific rules.
  • FAA Reverse Magnetic Track—The magnetic north azimuth of the route segment's reverse track from its end point will be calculated using FAA specific rules.
  • FAA True Track2—The true north azimuth of the route collection from its start point will be calculated using FAA specific rules.
  • FAA Reverse True Track2—The true north azimuth of the route collection from its end point will be calculated using FAA specific rules.
  • FAA Magnetic Track2—The magnetic north azimuth of the route collection from its start point will be calculated using FAA specific rules.
  • FAA Reverse Magnetic Track2—The magnetic north azimuth of the route collection from its end point will be calculated using FAA specific rules.
  • FAA Altitude Change Status—A numeric indicator showing how a route's segment altitude changes from the previous segment in a route collection.

• Selecting at least one of the four FAA specific route segment-based bearing attributes (FAA True Track, FAA Reverse True Track, FAA Magnetic Track, or FAA Reverse Magnetic Track) will calculate bearing values for a route segment.

• Selecting at least one of the four FAA specific route collection-based bearing attributes (FAA True Track2, FAA Reverse True Track2, FAA Magnetic Track2, or FAA Reverse Magnetic Track2) will calculate bearing values for a route collection. For each ATS Route Feature in a route collection, the same route bearing value will be written. However, if the route collection has dogleg points, different bearing values will be calculated and written for the parts of a route collection that are bounded by them.

  The following additional input parameters will be required to perform any of the FAA specific bearing calculations:

  • Input DesignatedPoint Feature Layer
  • Input NavaidComponent Feature Layer
  • Input Designated Point Navaid Association Table
  • Input Navaid Association Table
  • Input Enrouteinformation Table

• 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.

  The ATS Route feature layer may contain the following FAA specific bearing attributes that can also be used as input fields: TRUETRACK2_VAL, REVERSETRUETRACK2_VAL, MAGTRACK2_VAL, and REVERSEMAGTRACK2_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. FAA True Track—The true north azimuth of the route segment's track from its start point will be calculated using FAA specific rules. FAA Reverse True Track—The true north azimuth of the route segment's reverse track from its end point will be calculated using FAA specific rules. FAA Magnetic Track—The magnetic north azimuth of the route segment's track from its start point will be calculated using FAA specific rules. FAA Reverse Magnetic Track—The magnetic north azimuth of the route segment's reverse track from its end point will be calculated using FAA specific rules. FAA True Track2—The true north azimuth of the route collection from its start point will be calculated using FAA specific rules. FAA Reverse True Track2—The true north azimuth of the route collection from its end point will be calculated using FAA specific rules. FAA Magnetic Track2—The magnetic north azimuth of the route collection from its start point will be calculated using FAA specific rules. FAA Reverse Magnetic Track2—The magnetic north azimuth of the route collection from its end point will be calculated using FAA specific rules. FAA Altitude Change Status—A numeric indicator showing how a route's segment altitude changes from the previous segment in a route collection.	Value Table
Magnetic Variation Date (Optional)	The date for which the magnetic field values will be calculated.	Date
Input DesignatedPoint Feature Layer (Optional)	The designated point coordinates that will be used to calculate the bearing of a route collection. This parameter is only used when an FAA bearing attribute is specified for the ATS Route Attributes parameter value.	Feature Layer
Input NavaidComponent Feature Layer (Optional)	The magnetic variation value SlavedVariation_Val will be used as the magnetic variation value in a bearing calculation if the start or end of a route collection is collated with a Navaid component. This parameter is only used when an FAA bearing attribute is specified for the ATS Route Attributes parameter value.	Feature Layer
Input Designated Point Navaid Association Table (Optional)	An association table that will be used to determine whether a designated point is collocated with a Navaid component. This parameter is only used when an FAA bearing attribute is specified for the ATS Route Attributes parameter value.	Table View
Input Navaid Association Table (Optional)	An association table that will be used to associate a designated point to a Navaid component. This parameter is only used when an FAA bearing attribute is specified for the ATS Route Attributes parameter value.	Table View
Input EnrouteInformation Table (Optional)	A table that contains the total mileage of a route collection. It also contains dogleg points along a route collection and is needed to calculate a route collection's bearing values. This parameter is only used when an FAA bearing attribute is specified for the ATS Route Attributes parameter value.	Table View

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}, {in_designatedpoint_features}, {in_navaidcomponent_features}, {in_desigpointnavaid_assoc_table}, {in_navaid_assoc_table}, {in_enroute_table})

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. FAA_TRUE_TRACK—The true north azimuth of the route segment's track from its start point will be calculated using FAA specific rules. FAA_REVERSE_TRUE_TRACK—The true north azimuth of the route segment's reverse track from its end point will be calculated using FAA specific rules. FAA_MAG_TRACK—The magnetic north azimuth of the route segment's track from its start point will be calculated using FAA specific rules. FAA_REVERSE_MAG_TRACK—The magnetic north azimuth of the route collection from its end point will be calculated using FAA specific rules. FAA_TRUE_TRACK2—The true north azimuth of the route collection from its start point will be calculated using FAA specific rules. FAA_REVERSE_TRUE_TRACK2—The true north azimuth of the route collection from its end point will be calculated using FAA specific rules. FAA_MAG_TRACK2—The magnetic north azimuth of the route collection from its start point will be calculated using FAA specific rules. FAA_REVERSE_MAG_TRACK2—The magnetic north azimuth of the route collection from its end point will be calculated using FAA specific rules. FAA_ALTITUDE_CHANGE_STATUS—A numeric indicator showing how a route's segment altitude changes from the previous segment in a route collection.	Value Table
magnetic_variation_date (Optional)	The date for which the magnetic field values will be calculated.	Date
in_designatedpoint_features (Optional)	The designated point coordinates that will be used to calculate the bearing of a route collection. This parameter is only used when an FAA bearing attribute is specified for the atsroute_attributes parameter value.	Feature Layer
in_navaidcomponent_features (Optional)	The magnetic variation value SlavedVariation_Val will be used as the magnetic variation value in a bearing calculation if the start or end of a route collection is collated with a Navaid component. This parameter is only used when an FAA bearing attribute is specified for the atsroute_attributes parameter value.	Feature Layer
in_desigpointnavaid_assoc_table (Optional)	An association table that will be used to determine whether a designated point is collocated with a Navaid component. This parameter is only used when an FAA bearing attribute is specified for the atsroute_attributes parameter value.	Table View
in_navaid_assoc_table (Optional)	An association table that will be used to associate a designated point to a Navaid component. This parameter is only used when an FAA bearing attribute is specified for the atsroute_attributes parameter value.	Table View
in_enroute_table (Optional)	A table that contains the total mileage of a route collection. It also contains dogleg points along a route collection and is needed to calculate a route collection's bearing values. This parameter is only used when an FAA bearing attribute is specified for the atsroute_attributes parameter value.	Table View

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