Group Route Segments (Aviation)

Available with Aviation Charting license.

Summary

Derives additional cumulative information such as the total distance of a route or route portion from individual segments to prepare data for charting.

This tool identifies routes and route portions in FAA and NGA ATSRoute data.

A route collection is an ordered set of ATSRoute segments from a NAVAID to a NAVAID. For each route collection identified, an entry will be stored in the EnrouteInformation stand-alone table with the total calculated distance of each group.

A route portion collection is a subset of an en route collection containing segments from a compulsory point to a compulsory point. A route portion can also go from a NAVAID or compulsory point to a NAVAID or compulsory point. For each route portion collection identified, an entry will be stored in the RoutePortion stand-alone table.

Usage

• The tool requires the following feature classes, tables, and attributes:

  Name	Required fields
  ATSRoute—Feature class	IDENT_TXT EnrouteInformation_Id StartPoint_Id EndPoint_Id RepATCStart_Code RepATCEnd_Code
  EnrouteInformation—Stand-alone table	GFID Distance_Val
  RoutePortion—Stand-alone table	GFID EnrouteInformation_Id Distance_Val StartPoint_Id EndPoint_Id
  DesigPoint_NavaidAssoc—Stand-alone table	This is required to determine collocation of a designated point with a NAVAID.

  If required attributes are missing, an error occurs listing the dataset name and missing attributes.

  Note:

  The ArcGIS Aviation Charting product files contain additional information about the AIS schemas that are available for download.

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.

Parameters

Dialog

Label	Explanation	Data Type
Target ATS Route Features	The input feature class for the ATSRoute feature class that contains polylines. The Enrouteinformation_Id and the RoutePortion_Id attributes will be updated.	Feature Layer
Target Enrouteinformation Table	The table that will be updated to contain entries for the en routes identified during processing. The Distance_val attribute is set to the total length of the en route's segments. The Distance_val attribute is updated and kept up to date on new and existing en routes.	Table View
Target RoutePortion Table	The table that will be updated to contain entries for the route portions identified during processing. The Distance_val attribute is set to the total length of the route portions' segments. The route portions' StartPoint_Id and EndPoint_Id attributes will also be updated to refer to the start and end point of a route portion.	Table View
Designated Point Navaid Association Table	The association table, DesigPoint_NavaidAssoc, that contains the relationships between designated points and NAVAID systems. The ATSRoute feature class's start and end designated point's GFID field will reference entries in this table. This table indicates whether a point is collocated with a NAVAID and helps determine the grouping of route segments.	Table View

Derived Output

Label	Explanation	Data Type
Modified Target ATS Route Features	The target ATSRoute feature layer with updated fields.	Feature Layer
Modified Target Enrouteinformation Table	The target Enrouteinformation table with updated fields.	Table View
Modified Target RoutePortion Table	The target routeportion table with updated fields.	Table View

Python

arcpy.aviation.GroupRouteSegments(target_atsroute_features, target_enroute_table, target_routeportion_table, in_association_table)

Name	Explanation	Data Type
target_atsroute_features	The input feature class for the ATSRoute feature class that contains polylines. The Enrouteinformation_Id and the RoutePortion_Id attributes will be updated.	Feature Layer
target_enroute_table	The table that will be updated to contain entries for the en routes identified during processing. The Distance_val attribute is set to the total length of the en route's segments. The Distance_val attribute is updated and kept up to date on new and existing en routes.	Table View
target_routeportion_table	The table that will be updated to contain entries for the route portions identified during processing. The Distance_val attribute is set to the total length of the route portions' segments. The route portions' StartPoint_Id and EndPoint_Id attributes will also be updated to refer to the start and end point of a route portion.	Table View
in_association_table	The association table, DesigPoint_NavaidAssoc, that contains the relationships between designated points and NAVAID systems. The ATSRoute feature class's start and end designated point's GFID field will reference entries in this table. This table indicates whether a point is collocated with a NAVAID and helps determine the grouping of route segments.	Table View

Derived Output

Name	Explanation	Data Type
modified_target_atsroute_features	The target ATSRoute feature layer with updated fields.	Feature Layer
modified_target_enroute_table	The target Enrouteinformation table with updated fields.	Table View
modified_target_routeportion_table	The target routeportion table with updated fields.	Table View

Code sample

GroupRouteSegments example (stand-alone script)

The following script demonstrates how to use the GroupRouteSegments function.

# Import system modules
import arcpy

# Check out extensions
arcpy.CheckOutExtension('Aeronautical')

# Set local variables
target_atsroute_features = r"C:\data\aeronautical.gdb\ATSRoutes"
target_enroute_table = r"C:\data\aeronautical.gdb\EnrouteInformation"
target_routeportion_table = r"C:\data\aeronautical.gdb\RoutePortion"
in_association_table = r"C:\data\aeronautical.gdb\DesigPoint_NavaidAssoc"

# Call the GroupRouteSegments tool
arcpy.aviation.GroupRouteSegments(target_atsroute_features, target_enroute_table,\
                                  target_routeportion_table, in_association_table)

# Check in extensions
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