Generate Airspace Lines (Aviation)

Available with Aviation Charting license.

Summary

Generates line features in the AirspaceLine feature class from the edges of input Airspace polygon features.

AirspaceLine features can be used as the basis for charting complex line symbols where coincident or intersecting boundaries of different Airspace types may require special symbology for clarity. Similarly, labels or annotation can be generated along the lines, specifying the Airspace features on either side.

The AirspaceLine LINESYMBOL.TXT field will be populated with Airspace TYPE_CODE source values. The AirspaceLine RIGHTLABEL_TXT and AirspaceLine LEFTLABEL_TXT fields will be populated with configured field values from the contributing right and left source Airspace features.

The tool will add, modify, or delete AirspaceLine features as needed when subsequently run with updated Airspace features.

The tool uses preferences to define how it will process polyline features. These preferences are available in the Aviation Preferences tool and should be configured before running the Generate Airspace Lines tool.

Usage

  • The Target Airspace Line Features parameter value contains the AirspaceLine feature class that will have features that will be added, modified, or deleted based on the topological relationships between the Area of Interest Features parameter value and the Input Airspace Features parameter value.

  • The Area of Interest Features parameter value is used to set a boundary within which airspace polygon features will be processed. Airspace polygon features that wholly or partially overlap the area of interest (AOI) will be processed. The tool honors definition query and selection on the input AOIs.

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

  • You must populate the Preference Table parameter and then add at least one Generate Airspace Lines preference to the Preference parameter before running this tool. These preferences will define how the tool generates airspace lines.

    Learn more about creating preferences

  • For best results, sufficiently densify the airspace polygons before running this tool. Run the Geodesic Densify tool with the default parameter options on the airspaces; then run this tool. This results in the output having better alignment with the initial input airspace edges.

  • The following fields are required for this tool's input feature classes:

    Parameter nameAIS sourceRequired field

    Input Airspace Features

    Airspace

    TYPE_CODE, GFID, and Name_TXT

    Target Airspace Line Features

    AirspaceLine

    LINESYMBOL_TXT, LEFTLABEL_TXT, RIGHTLABEL_TXT, GFID, LASTMOD_DATE, PREFERENCE_TXT, and MAPID_TXT

    Area of Interest Features

    AIS_AOI

    MAPID

    Preference Table

    AIS_Preferences

    NAME and JSON

  • The tool will display messages summarizing the number of airspace polyline features that were added, updated, or deleted for each processed AOI feature.

  • The Label Airspaces parameter changes how airspace lines are generated and labeled. If the Label Airspaces parameter is unchecked, the output line features will contain information from neighboring airspaces. If the Label Airspaces parameter is checked, the output line features will contain information from both intersecting and neighboring airspaces.

  • The cluster tolerance, also known as the x,y tolerance, refers to the minimum distance between coordinates before they are considered equal. It is used during processing the airspaces to determine which lines are sharing an edge. The default cluster tolerance refers to the x,y tolerance defined for given a feature class's properties.

Parameters

LabelExplanationData Type
Input Airspace Features

The polygon feature classes containing the airspace boundaries.

Feature Layer
Target Airspace Line Features

The polyline feature class containing the airspace line data.

Feature Layer
Area of Interest Features

The polygon feature class containing the AOI data.

The selected polygon features will be used to filter the airspace lines that will be added, modified, or deleted.

Feature Layer
Preference Table

The table of preferences that define how the airspace lines will be added, modified, or deleted.

Table View
Preference

The name of a preference in the Preference Table parameter value. The selected preference defines how the airspace lines will be added, modified, or deleted.

String
Label Airspaces
(Optional)

Specifies whether the output line's left and right labels will aggregate and show the labels of the intersecting airspaces that the line is within.

  • Unchecked—The left and right labels of the output lines will contain the airspace labels of the coincident airspaces only. Intersecting airspaces will not be included. Only coincident airspaces that touch the airspace line within the preference cluster tolerance will be identified. This is the default.
  • Checked—The left and right labels of the output lines will contain airspace labels of intersecting airspaces and coincident airspaces. Only coincident airspaces that touch the airspace line within the default cluster tolerance will be identified.
Boolean

Derived Output

LabelExplanationData Type
Updated Airspace Line Features

The updated Target Airspace Line Features value.

Feature Layer

arcpy.aviation.GenerateAirspaceLines(in_airspace_features, target_airspace_line_features, aoi_features, preference_table, preference, {label_airspaces})
NameExplanationData Type
in_airspace_features
[in_airspace_features,...]

The polygon feature classes containing the airspace boundaries.

Feature Layer
target_airspace_line_features

The polyline feature class containing the airspace line data.

Feature Layer
aoi_features

The polygon feature class containing the AOI data.

The selected polygon features will be used to filter the airspace lines that will be added, modified, or deleted.

Feature Layer
preference_table

The table of preferences that define how the airspace lines will be added, modified, or deleted.

Table View
preference
[preference,...]

The name of a selected preference in the preference_table parameter value. The selected preference defines how the airspace lines will be added, modified, or deleted.

String
label_airspaces
(Optional)

Specifies whether the output line's left and right labels will aggregate and show the labels of the intersecting airspaces that the line is within.

  • NO_INTERSECTING_AIRSPACESThe left and right labels of the output lines will contain the airspace labels of the coincident airspaces only. Intersecting airspaces will not be included. Only coincident airspaces that touch the airspace line within the preference cluster tolerance will be identified. This is the default.
  • INTERSECTING_AIRSPACESThe left and right labels of the output lines will contain airspace labels of intersecting airspaces and coincident airspaces. Only coincident airspaces that touch the airspace line within the default cluster tolerance will be identified.
Boolean

Derived Output

NameExplanationData Type
updated_airspace_line_features

The updated target_airspace_line_features value.

Feature Layer

Code sample

GenerateAirspaceLines example (Python)

The following code sample demonstrates how to use the GenerateAirspaceLines function.

# Name: GenerateAirspaceLines_example.py
# Description: Adds, deletes, and/or updates airspace line features based on the coincident
# boundaries of airspace polygon features.

import arcpy

# Check out Aviation license

arcpy.CheckOutExtension("Aeronautical")

# Set variables

airspace_lines = r'c:\data\AIS.gdb\AirspaceLines'

airspace = r'c:\data\AIS.gdb\Airspace'

aoi = r'c:\data\AIS.gdb\AOI'

preference_table = r'c:\data\AIS.gdb\Preferences'

preference = ['Enroute_Low', 'Class E']

label_airspaces = 'INTERSECTING_AIRSPACES'

# Execute GenerateAirspaceLines

arcpy.aviation.GenerateAirspaceLines(
    [airspace] , airspace_lines, aoi, preference_table, preference, label_airspaces)

# 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