FAA 13A (Aviation)—ArcGIS Pro

Available with Aviation Airports license.

Available with Aviation Charting license.

Summary

Creates obstruction identification surfaces (OIS) based on the FAA Advisory Circular 150/5300-13A specification. These approach and departure surfaces are designed to protect the use of the runway in both visual and instrument meteorological conditions near the airport and are used to support planning and design activities. The type, function, and dimension of a surface differ by its runway classification. This tool creates surfaces as a polygon or multipatch features.

Usage

The Input Runway Features parameter must be z-enabled.
This tool creates the OIS in an existing polygon or multipatch feature class. It can also be generated in an existing polygon shapefile. If a feature class is selected for Target OIS Features, it must have a vertical spatial reference.
To create a JSON file for Custom JSON File, use the CustomizeOIS.exe file that is part of the ArcGIS Aviation data package available from My Esri.
OIS tools are flexible and accept a variety of input and output feature class types. For more information, see the OIS Input and Output schemas.
A departure runway classification can include a clearway surface. Clearway length, slope, width, and negative offset distance must be provided in the Custom JSON File parameter.
The Input Airport Control Point Feature parameter can be used to supply x-, y-, and z-geometry for displaced threshold features. If displaced thresholds are included, surfaces will be constructed based on their x-, y-, and z-geometry instead of their corresponding runway feature endpoint.

Syntax

arcpy.aviation.FAA13A(in_features, target, runway_type, {highend_clear_way_length}, {lowend_clear_way_length}, {custom_json_file}, {generate_clearway_surface}, {airport_control_point_feature_class})

Parameter	Explanation	Data Type
in_features	The input runway dataset. The feature class must be z-enabled and contain polylines.	Feature Layer
target	The target feature class that will contain the generated OIS.	Feature Layer
runway_type	Specifies the classification of the runway. SMALL_AIRPLANE_APPROACH_SPEEDS_LT_50 —Approach end of runways are expected to serve small airplanes with approach speeds less than 50 knots. This applies to visual runways only, day or night. SMALL_AIRPLANE_APPROACH_SPEEDS_GT_50 —Approach end of runways are expected to serve small airplanes with approach speeds of 50 knots or more. This applies to visual runways only, day or night. LARGE_AIRPLANE_VISUAL_RUNWAY_DAY_NIGHT —Approach end of runway are expected to serve large airplanes. This applies to visual runways only, day or night. INSTRUMENT_GT_EQ_3/4_MILE — Approach end of runways are expected to accommodate instrument approaches having visibility greater than or equal to 3/4 statute mile. INSTRUMENT_LT_3/4_MILE_VISIBILITY —Approach end of runways are expected to accommodate instrument approaches having visibility minimums less than 3/4 statute mile. VERTICAL_GUIDANCE_APPROACH —Approach end of runways are expected to accommodate instrument approaches with vertical guidance. DEPARTURE — Departure runway ends are used for any instrument operations.	String
highend_clear_way_length (Optional)	Legacy: This parameter is no longer supported. It is still included in the tool's syntax for compatibility in scripts and models but is hidden on the tool dialog box.	Double
lowend_clear_way_length (Optional)	Legacy: This parameter is no longer supported. It is still included in the tool's syntax for compatibility in scripts and models but is hidden on the tool dialog box.	Double
custom_json_file (Optional)	The import configuration, in JSON format, that creates the custom OIS.	File
generate_clearway_surface (Optional)	Specifies whether a clearway surface will be generated for departure runways. GENERATE_CLEARWAY_SURFACE —A clearway surface will be generated. NOT_GENERATE_CLEARWAY_SURFACE — A clearway surface will not be generated. This is the default.	Boolean
airport_control_point_feature_class (Optional)	Supplies x-, y-, and z-geometry for displaced threshold features. If displaced thresholds are included, surfaces will be constructed based on their x-, y-, and z-geometry instead of their corresponding runway feature endpoint.	Feature Layer

Derived Output

Name	Explanation	Data Type
derived_outfeatureclass	The updated feature class containing the generated OIS.	Feature Layer

Code sample

FAA13A example 1 (stand-alone script)

The following Python window script demonstrates how to use the FAA13A function.

import arcpy

# set gp environment
arcpy.CheckOutExtension("Aeronautical")

# Input Runway Feature Class
inFeatures = r"C:\data\ois.gdb\RunwayCenterline"

# Feature class that will contain the OIS surface
outFeatures = r"C:\data\ois.gdb\ObstructionIdSurface"

# Airport variables
runway = "SMALL_AIRPLANES_APPROACH_SPEEDS_LT_50"

# Generate FAA13A OIS
arcpy.FAA13A_aviation(inFeatures, outFeatures, runway)

arcpy.CheckInExtension("Aeronautical")

FAA13A example 2 (stand-alone script)

The following Python window script demonstrates how to use the FAA13A function with the custom_json_file parameter.

import arcpy

# set gp environment
arcpy.CheckOutExtension("Aeronautical")

# Input Runway Feature Class
inFeatures = r"C:\data\ois.gdb\RunwayCenterline"

# Feature class that will contain the OIS surface
outFeatures= r"C:\data\ois.gdb\ObstructionIdSurface"

# Airport variables
runway = "DEPARTURE"
hiEndClearWay = 0  # parameter is disregarded for FAA13A, set Clearway dimension in Custom JSON
lowEndClearWay = 0 # parameter is disregarded for FAA13A, set Clearway dimension in Custom JSON
customJSON = r"C:\data\customOIS.json"
Clearway_Surface = “GENERATE_CLEARWAY_SURFACE”

# Generate FAA13A OIS
arcpy.FAA13A_aviation(inFeatures, outFeatures, runway, hiEndClearWay,
                      lowEndClearWay, customJSON, Clearway_Surface)

arcpy.CheckInExtension("Aeronautical")

Environments

Current Workspace

Licensing information

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