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:

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

Parameters

LabelExplanationData Type
Input Route Features

The polyline feature layer containing air traffic service (ATS) route data. This data will be used to update features in the Target Cartographic Route Features feature layer.

Feature Layer
Target Cartographic 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
Area of Interest 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

LabelExplanationData Type
Updated Cartographic Route Features

The updated cartographic feature layer containing updated air traffic service (ATS) route features.

Feature Layer

arcpy.aviation.ProcessAirTrafficServiceRoutes(in_route_features, target_carto_route_features, aoi_features, preference_table, preference)
NameExplanationData 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

NameExplanationData 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

Related topics