Add Aviation Line Bypass (Aviation)

Available with Aviation Charting license.

Summary

Adjusts route polyline features that overlap point features.

In some cases, an Air Traffic Service (ATS) route may pass through a point such as a navigational aid (navaid) or designated point that is not designated as part of its airway structure. For those cases, the ATS route's line symbol can be depicted as a bypass around the point to more clearly show that the ATS route does not include the point.

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

An ATS route with a line bypass is shown.

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.

• Input polyline and point features must be included in the same map that you designate for the Input Map parameter. Input polyline and point features are passed by reference from the input map, not a geodatabase workspace.

• 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 parameter value will be processed by this tool.

• The Radius Scale Factor parameter is only valid if the Radius Option parameter value is Dynamic Radius.

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

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

Parameters

Dialog

Label	Explanation	Data Type
Input Map	The input map with a set reference scale.	Map
Target Line Features	The polyline features representing ATS routes.	String
Bypass Features (Optional)	The point features that the Target Line Features parameter value will bypass.	String
Tolerance (Optional)	The maximum distance between the center point of a bypass feature and a route. If no linear unit is 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 the Radius Option parameter value is Dynamic Radius.	Double
Radius (Optional)	The radius of a bypass with a constant radius. This parameter is only valid if the Radius Option parameter value is Constant Radius. If no linear unit is 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

Label	Explanation	Data Type
Updated Line Features	The polyline feature class containing bypass lines.	Feature Layer

Python

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

Name	Explanation	Data Type
in_map	The input map with a set reference scale.	Map
target_line_features	The polyline features representing ATS routes.	String
bypass_features [bypass_features,...] (Optional)	The point features that the target_line_features parameter value will bypass.	String
tolerance (Optional)	The maximum distance between the center point of a bypass feature and a route. If no linear unit is 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 (Optional)	The amount a bypass with a dynamic radius will be scaled. This parameter is only valid if the radius_option parameter value is DYNAMIC_RADIUS.	Double
radius (Optional)	The radius of a bypass with a constant radius. This parameter is only valid if the radius_option parameter value is CONSTANT_RADIUS. If no linear unit is 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_BYPASS—Consecutive bypass lines will not be merged. This is the default. MERGE_BYPASS—Consecutive bypass lines will be merged.	String

Derived Output

Name	Explanation	Data Type
updated_line_features	The polyline feature class containing bypass lines.	Feature Layer

Code sample

AddAviationLineBypass example 1 (stand-alone script)

The following script 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")

# Create a reference to the project file (.aprx) containing your map

aprx = arcpy.mp.ArcGISProject(r"D:\My Project.aprx")
map = aprx.listMaps("My Map")[0]

# Parameters

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(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 script 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")

# Create a reference to the project file (.aprx) containing your map

aprx = arcpy.mp.ArcGISProject(r"D:\My Project.aprx")
map = aprx.listMaps("My Map")[0]

# Parameters

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(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: Requires ArcGIS Aviation Charting