Add Aviation Line Bypass (Aviation)

Summary

Adjusts route polyline features that overlap point features.

Navigational aids (navaids) are represented on a chart as points that can be symbolized according to their classification. Navaids can represent facilities on the ground, such as a VOR, or imaginary way points as is the case with RNAV. Air Traffic Service (ATS) routes pass over navaids at various points throughout a flight. Navaids can be considered part of the route when they fall directly on the ATS route indicating a change in course, an intermediate step during the flight, or a transition to another route. Because ATS routes can overlap at multiple flight levels on a chart, it can be difficult to tell if a navaid is a part of a route or if the route bypasses the navaid.

When an ATS route bypasses a navaid, the route representing the line is curved slightly where the navaid intersects the route. This does not indicate that the flight path has changed, only that the navaid is not considered part of the ATS route. The following images show the difference between an ATS route that includes a navaid and a route that bypasses a navaid on a navigational chart.

Add Aviation Line Bypass tool illustration
An ATS route with a line bypass is shown.
Add Aviation Line Bypass tool illustration
An ATS route with no line bypass is shown.

Usage

  • This tool processes selected polyline features on a map. If no polyline feature is selected, the tool will process all polyline features in the feature class.

  • The Input Map parameter must have a set reference scale.

    Learn more about setting a reference scale in ArcGIS Pro

  • If you do not provide features for the Bypass Features parameter, the tool will revert all lines with bypass symbology to straight lines.

  • Only selected features in the Target Line Features value will be processed by this tool.

  • The Radius Scale parameter is only valid if you select Dynamic Radius as the Radius Option parameter value.

  • The Radius parameter is only valid if you select Constant Radius as the Radius Option parameter value.

  • If you do not provide a value for the Tolerance parameter, all features with overlapping symbology will be processed.

Parameters

LabelExplanationData Type
Input Map

The input map with a set reference scale.

Map
Target Line Features

The polyline features representing Air Traffic Service (ATS) routes.

String
Bypass Features
(Optional)

The point features that the Target Line Features value will bypass.

String
Tolerance
(Optional)

The maximum distance between the center point of a bypass feature and a route.

If the linear unit is not specified or is set to Unknown, it will be the same as the input map's spatial reference.

Linear Unit
Radius Option
(Optional)

Specifies the type of bypass radius that will be used.

  • Dynamic Radius — The radius will be dynamic relative to its scale factor. This is the default.
  • Constant Radius — The radius will be a constant radius.
String
Radius Scale Factor
(Optional)

The amount a bypass with a dynamic radius will be scaled. This parameter is only valid if Dynamic Radius is selected as the Radius Option parameter value.

Double
Radius
(Optional)

The radius of a bypass with a constant radius. This parameter is only valid if Constant Radius is selected as the Radius Option parameter value.

If the linear unit is not specified or is set to Unknown, it will be the same as the input map's spatial reference.

Linear Unit
Merge Option
(Optional)

Specifies whether consecutive bypass lines will be merged.

  • Consecutive bypass lines will not be merged. — Consecutive bypass lines will not be merged. This is the default.
  • Consecutive bypass lines will be merged. — Consecutive bypass lines will be merged.
String

Derived Output

LabelExplanationData Type
Updated Line Features

The polyline feature class containing bypass lines.

Feature Layer

arcpy.aviation.AddAviationLineBypass(in_map, target_line_features, {bypass_features}, {tolerance}, {radius_option}, {radius_scale}, {radius}, {merge_option})
NameExplanationData Type
in_map

The input map with a set reference scale.

Map
target_line_features

The polyline features representing Air Traffic Service (ATS) routes.

String
bypass_features
[bypass_features,...]
(Optional)

The point features that the target_line_features value will bypass.

String
tolerance
(Optional)

The maximum distance between the center point of a bypass feature and a route.

If the linear unit is not specified or is set to Unknown, it will be the same as the input map's spatial reference.

Linear Unit
radius_option
(Optional)

Specifies the type of bypass radius that will be used.

  • DYNAMIC_RADIUSThe radius will be dynamic relative to its scale factor. This is the default.
  • CONSTANT_RADIUSThe radius will be a constant radius.
String
radius_scale
(Optional)

The amount a bypass with a dynamic radius will be scaled. This parameter is only valid if DYNAMIC_RADIUS is selected as the radius_option parameter value.

Double
radius
(Optional)

The radius of a bypass with a constant radius. This parameter is only valid if CONSTANT_RADIUS is selected as the radius_option parameter value.

If the linear unit is not specified or is set to Unknown, it will be the same as the input map's spatial reference.

Linear Unit
merge_option
(Optional)

Specifies whether consecutive bypass lines will be merged.

  • NO_MERGE_BYPASSConsecutive bypass lines will not be merged. This is the default.
  • MERGE_BYPASSConsecutive bypass lines will be merged.
String

Derived Output

NameExplanationData Type
updated_line_features

The polyline feature class containing bypass lines.

Feature Layer

Code sample

AddAviationLineBypass example 1 (stand-alone script)

The following demonstrates how to use the AddAviationLineBypass function to generate bypasses with a dynamic radius.

# Name: AddAviationBypassLines_Dynamic_Radius_example.py

# Description: ArcGIS geoprocessing tool that adjusts route
# polyline features which overlap point features.


import arcpy

# Check out Aeronautical extension

arcpy.CheckOutExtension("Aeronautical")

# Set workspace to AIS geodatabase

arcpy.env.workspace = "D:\data.gdb"

# Parameters

in_map = "MyMap"
target_line_features = "ATSRoute"
bypass_features = ["ADHP", "NavaidComponent"]
tolerance = "1 kilometer"
radius_option = "DYNAMIC_RADIUS"
radius_scale = 1.0
radius = ""
merge_option = "MERGE_BYPASS"

# Run AddAviationLineBypass

arcpy.aviation.AddAviationLineBypass(in_map, target_line_features, bypass_features, tolerance, radius_option, radius_scale, radius, merge_option)

# Check in Aeronautical extension

arcpy.CheckInExtension("Aeronautical")
AddAviationLineBypass example 2 (stand-alone script)

The following demonstrates how to use the AddAviationLineBypass function to generate bypasses with a constant radius.

# Name: AddAviationBypassLines_Constant_Radius_example.py

# Description: ArcGIS geoprocessing tool that adjusts route
# polyline features which overlap point features.


import arcpy

# Check out Aeronautical extension

arcpy.CheckOutExtension("Aeronautical")

# Set workspace to AIS geodatabase

arcpy.env.workspace = "D:\data.gdb"

# Parameters

in_map = "MyMap"
target_line_features = "ATSRoute"
bypass_features = ["ADHP", "NavaidComponent"]
tolerance = "1 kilometer"
radius_option = "CONSTANT_RADIUS"
radius_scale = 1.0
radius = "0.1 kilometer"
merge_option = "MERGE_BYPASS"

# Run AddAviationLineBypass

arcpy.aviation.AddAviationLineBypass(in_map, target_line_features, bypass_features, tolerance, radius_option, radius_scale, radius, merge_option)

# 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: No

Related topics