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 such 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.
Syntax
FAA13A(in_features, target, runway_type, {highend_clear_way_length}, {lowend_clear_way_length}, {custom_json_file}, {generate_clearway_surface})
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.
| String |
highend_clear_way_length (Optional) | Note:This is a legacy parameter that is no longer supported. This parameter is still included in the tool's syntax for compatibility in scripts and models but is hidden in the tool's dialog box. | Double |
lowend_clear_way_length (Optional) | Note:This is a legacy parameter that is no longer supported. This parameter is still included in the tool's syntax for compatibility in scripts and models but is hidden in the tool's 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.
| Boolean |
Derived Output
Name | Explanation | Data Type |
derived_outfeatureclass | The updated feature class containing the generated OIS. | Feature Layer |
Code sample
The following Python window script demonstrates how to use the FAA13A tool.
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")
The following Python window script demonstrates how to use the FAA13A tool 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
Licensing information
- Basic: No
- Standard: Requires Airports, ArcGIS Aviation Charting
- Advanced: Requires Airports, ArcGIS Aviation Charting