Process Air Traffic Service Routes (Aviation Tools)

Summary

Identifies overlapping Air Traffic Service (ATS) routes and calculates fields in the Target Cartographic Route Features to aid in cartographic display.

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 Target Cartographic Route Features will have their IsVisible field set to 1 (Yes) on the first route and the IsVisible field set to 0 (No) on subsequent overlapping routes, allowing them to be filtered with a definition query.
  
  Note:
  
  If the Hide Overlapping Routes option is checked, the Offset Overlapping Routes option has no effect on the output.
- 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 Target Cartographic Route Features will be populated with the IDENT_TXT values from the coincident input route features. Where overlapping routes share a route prefix, such as V25 and V87, they will be concatenated with a hyphen, for example, V25-87.
- Offset Overlapping Routes—Positive and negative numeric values in the ROUTEOFFSET_VAL field in the Target Cartographic Features will be calculated for overlapping routes.
  
  Note:
  
  If you check this option, you must provide a value for Offset Value, which determines how far apart the features appear on a chart.
  
  These values can be used as input to symbolize the features in a map.
  
  Note:
  
  The Hide Overlapping Routes option takes precedence over the Offset Overlapping Routes option.
Learn more about creating route processing preferences
The Input Route Features parameter value 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 parameter 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 active 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.
The ROUTEOFFSET_VAL field will be computed using the following algorithm.

For each grouping of identical cartographic features, the tool will first define a distribution range determined by the following formula:

(The Preference Route Offset Value) * ((The number of identical features per group) - 1) / 2

That range will be defined from the negative value of this computation to the positive value. The distribution range will determine the minimum and maximum values that can be assigned in the ROUTEOFFSET_VAL field. For example, if the preference offset value was 4, and there were five cartographic features identified to be identical, the range would be [-8, 8]. Next, starting from the low value, each cartographic feature will be assigned an incrementing offset value that is a multiple of the preference offset. So, with five identical cartographic features, the ROUTEOFFSET_VAL values would be -8, -4, 0, 4, and 8.
Note:

The criteria for determining a grouping of identical features for computing the ROUTEOFFSET_VAL field is determined exclusively by the STARTPOINT_ID and ENDPOINT_ID fields. This offset computation algorithm doesn't consider any other attributes that may be specified in the preference in the Define Overlaps group in the Preference Details pane. So, the possible grouping criteria are as follows:
- The first criteria is the STARTPOINT_ID and ENDPOINT_ID values, and the user-selected attributes in the Define Overlaps group. It is used for computing the IDENTCONCAT_TXT value.
- The second criteria is that the STARTPOINT_ID and ENDPOINT_ID values are only used for computing the ROUTEOFFSET_VAL value.

Label	Explanation	Data type
Input Route Features	The polyline feature layer containing ATS route data. This data will be used to update features in the Target Cartographic Route Features parameter value.	Feature Layer
Target Cartographic Route Features	The cartographic feature layer containing 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 AOI features.	Feature Layer
Preference Table	The table of preferences that control how ATS routes will be processed.	Table View
Preference	The name of a preference from the Preference Table parameter value. The preference controls how ATS routes will be processed.	String

Derived output

Label	Explanation	Data type
Updated Cartographic Route Features	The updated cartographic feature layer containing updated ATS route features.	Feature Layer

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

Name	Explanation	Data type
in_route_features	The polyline feature layer containing ATS route data. This data will be used to update features in the `target_carto_route_features` parameter value.	Feature Layer
target_carto_route_features	The cartographic feature layer containing 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 AOI features.	Feature Layer
preference_table	The table of preferences that control how ATS routes will be processed.	Table View
preference	The name of a preference from the `preference_table` parameter value. The preference controls how ATS routes will be processed.	String

Derived output

Name	Explanation	Data type
updated_carto_route_features	The updated cartographic feature layer containing updated ATS route features.	Feature Layer

Code sample

ProcessAirTrafficServiceRoutes example (stand-alone script)

The following stand-alone 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

# 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"

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

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Process Air Traffic Service Routes (Aviation Tools)

Summary

Usage

Note:

Note:

Note:

Note:

Note:

Note:

Note:

Parameters

Derived output

Environments

Licensing information

Related topics