Process Air Traffic Service Routes (Aviation)

Available with Aviation Charting license.

Summary

Identifies, generalizes, and offsets overlapping Air Traffic Service (ATS) routes.

Using Process ATS Route preferences, this tool allows you to identify overlapping ATS routes on a chart. Once overlapping ATS routes have been identified, the tool uses the provided Process ATS Route preferences to generalize or offset the routes.

Usage

• The following preferences can be set in the input preferences table:

  Note:

  You must populate a preference table with route processing preferences before using this tool.

  • Hide Overlapping Routes—Overlapping routes will be hidden by selecting multiple fields that are used to identify overlapping features.
  • Concatenate Idents—Identifiers (denoted by the ATSRoute feature class's Ident_Txt field) will be combined for overlapping routes. The IdentConcat_Txt field in the ATSRoute_C feature class will be populated with the concatenated identifier values.
  • Offset Overlapping Routes—Overlapping routes will be offset by setting an input distance.

  Learn more about creating route processing preferences

• The Input Route Features parameter must contain polyline features.

• The following fields are required for this tool's parameters:

  Parameter	Required field
  Input Route Features	GFID, SHAPE, IDENT_TXT, STARTPOINT_ID, and ENDPOINT_ID
  Target Cartographic Route Features	MAPID_TXT, IDENTCONCAT_TXT, MASTER_ID, ROUTEOFFSET_VAL, and IsVisible
  Area of Interest Features	MAPID
  Preference Table	NAME and JSON

  Note:

  If you are using the AIS database schema included in the ArcGIS Aviation Charting product files, these required fields will be included in the schema's feature classes.

• The Area of Interest Features polygon feature class is used to set a boundary within which ATS route features will be processed. ATS route features that wholly or partially overlap the area of interest (AOI) will be processed.

  Note:

  The tool will only honor Area of Interest Features parameter values that are currently selected on a feature layer. If no features are selected, the tool will run using all features in the Area of Interest Features feature class.

• The Target Cartographic Route Features parameter value and the Updated Cartographic Route Features derived output refer to the same feature layer. The contents of the Target Cartographic Route Features feature layer will be overwritten by this tool.

Syntax

arcpy.aviation.ProcessAirTrafficServiceRoutes(in_route_features, target_carto_route_features, aoi_features, preference_table, preference)

Parameter	Explanation	Data Type
in_route_features	The polyline feature layer containing air traffic service (ATS) route data. This data will be used to update features in the target_carto_route_features feature layer.	Feature Layer
target_carto_route_features	The cartographic feature layer containing air traffic service (ATS) routes. The attributes of these features will be modified to simplify the display of overlapping routes.	Feature Layer
aoi_features	The polygon feature class containing area of interest (AOI) features.	Feature Layer
preference_table	The table of preferences that control how air traffic service (ATS) routes are processed.	Table View
preference	The name of a preference from the preference_table parameter. The preference controls how air traffic service (ATS) routes are processed.	String

Derived Output

Name	Explanation	Data Type
updated_carto_route_features	The updated cartographic feature layer containing updated air traffic service (ATS) route features.	Feature Layer

Code sample

ProcessAirTrafficServiceRoutes example (stand-alone script)

The following Python script demonstrates how to use the ProcessAirTrafficServiceRoutes function.

# Name: ProcessATSRoutes_example.py
# Description: Identifies, generalizes, and offsets overlapping air traffic service (ATS) routes

import arcpy

# Check out Aviation license

arcpy.CheckOutExtension("Aeronautical")

# Set variables

in_route_features = r'c:\data\AIS.gdb\ATSRoute'

target_carto_route_features = r'c:\data\AIS.gdb\ATSRoute_C'

aoi_features = r'c:\data\AIS.gdb\AOI'

preference_table = r'c:\data\AIS.gdb\Preferences'

preference = "MyPreferenceName"

# Execute ProcessATSRoutes 

arcpy.aviation.ProcessAirTrafficServiceRoutes(in_route_features, target_carto_route_features, aoi_features, preference_table, preference)

# Check in Aviation license

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