FAA 18B (Aviation Tools)

Summary

Creates obstruction identification surfaces (OIS) based on the FAA Advisory Circular 150/5300-18B specification. These OIS assist in the identification of possible hazards to air navigation and critical approach and departure obstructions within the vicinity of 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 polygon or multipatch features.

Usage

The Input Runway Features parameter must be z-enabled.
When Runway Classification is set to Vertical Guidance, the output transitional surface will be split into four sections by a line perpendicular to the runway centerline.
When Runway Classification is set to Vertical Guidance, the output conical and horizontal surfaces will be split into sections by a meridian and a parallel. The meridian intersects the Airport Elevation Point and the centerpoint of the runway centerline. The parallel runs perpendicular to the meridian through the centerpoint of the runway centerline.

Note:

In the absence of Airport Control Point Feature Class parameter values, the split will be based on the runway endpoint and runway centerpoint. The split will then draw a line from the runway endpoint and runway centerpoint and form a line parallel and perpendicular to the runway centerline.
This tool creates the OIS in an existing polygon or multipatch feature class. The OIS can also be generated in an existing polygon shapefile. If a feature class is used as the Target OIS Features parameter value, it must include a vertical spatial reference.
To create a .json file for the Custom JSON File parameter, use the CustomizeOIS.exe utility included in the Aviation Airports Product Data download available from My Esri.
The Airport Elevation parameter has a default value of 0. If you use an elevation value greater than 0, it takes precedence and overrides any existing airport elevation value read from the Input Airport Control Point Feature parameter.
The Input Airport Control Point Feature parameter can be used to supply x-, y-, and z-geometry for the Airport Elevation parameter, displaced threshold point features, or both. If displaced threshold points are included, surfaces will be constructed based on their x-, y-, and z-geometry instead of their corresponding Input Runway Feature parameter endpoint.
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.
High Runway End refers to runway direction identifiers 19 through 36. Low Runway End refers to runway direction identifiers 01 through 18.
If processing multiple runway features, check the Include Merged Surfaces parameter to create an additional Merged Horizontal Surface and Merged Conical Surface.

The additional merged surfaces will be continuous and will have an additional surface created to fill in the areas bounded by edges tangent to the outer edges of the individual surfaces.

Label	Explanation	Data type
Input Runway Features	The input runway dataset. The feature class must be z-enabled and contain polylines.	Feature Layer
Target OIS Features	The target feature class that will contain the generated OIS.	Feature Layer
Runway Classification	Specifies the runway classification for the Input Runway Features value. Non vertical guidance type 1—A runway designed for visual maneuvers, nonvertically guided operations, and instrument departure procedures. Non vertical guidance type 2—A specially prepared hard surface (SPHS) runway designed for visual maneuvers, nonvertically guided operations, and instrument departure procedures. SPHS runways have a primary surface that extends 200 feet beyond each end of the runway. Vertical guidance—A runway that uses precision guidance systems to support aircraft approach and landing.	String
Length of High Runway End Clearway (Optional)	The length of the area at the high end of the runway. The unit of measurement is based on the input runway features.	Double
Length of Low Runway End Clearway (Optional)	The length of the area at the low end of the runway. The unit of measurement is based on the input runway features.	Double
Airport Elevation (Optional)	The highest elevation on any of the runways of the airport. The value should be in the vertical coordinate system linear units of the target feature class. If no value is provided, the highest point from the Input Runway Features parameter value will be used.	Double
Include Merged Surfaces (Optional)	Specifies whether merged horizontal and conical surfaces will be included in the OIS in addition to the regular surfaces. Checked—Merged surfaces will be included in the OIS output. This is the default. Unchecked—Merged surfaces will not be included in the OIS output.	Boolean
Custom JSON File (Optional)	The import configuration, in JSON format, that will be used to create the custom OIS.	File
Input Airport Control Point Feature (Optional)	The point features containing an Airport Elevation feature, displaced threshold features, or both. Values provided for the Airport Elevation parameter will take precedence over these point features.	Feature Layer

Derived output

Label	Explanation	Data type
Output OIS Features	The updated feature class containing the generated OIS.	Feature Layer

arcpy.aviation.FAA18B(in_features, target, runway_type, {highend_clear_way_length}, {lowend_clear_way_length}, {airport_elevation}, {include_merged_surface}, {custom_json_file}, {airport_control_point_feature_class})

Name	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 runway classification for the `in_features` value. `NON_VERTICAL_GUIDANCE_TYPE_1`—A runway designed for visual maneuvers, nonvertically guided operations, and instrument departure procedures. `NON_VERTICAL_GUIDANCE_TYPE_2`—A specially prepared hard surface (SPHS) runway designed for visual maneuvers, nonvertically guided operations, and instrument departure procedures. SPHS runways have a primary surface that extends 200 feet beyond each end of the runway. `VERTICAL_GUIDANCE`—A runway that uses precision guidance systems to support aircraft approach and landing.	String
highend_clear_way_length (Optional)	The length of the area at the high end of the runway. The unit of measurement is based on the input runway features.	Double
lowend_clear_way_length (Optional)	The length of the area at the low end of the runway. The unit of measurement is based on the input runway features.	Double
airport_elevation (Optional)	The highest elevation on any of the runways of the airport. The value should be in the vertical coordinate system linear units of the target feature class. If no value is provided, the highest point from the `in_features` parameter value will be used.	Double
include_merged_surface (Optional)	Specifies whether merged horizontal and conical surfaces will be included in the OIS in addition to the regular surfaces. `INCLUDE_MERGED_SURFACE`—Merged surfaces will be included in the OIS output. This is the default. `NOT_INCLUDE_MERGED_SURFACE`—Merged surfaces will not be included in the OIS output.	Boolean
custom_json_file (Optional)	The import configuration, in JSON format, that will be used to create the custom OIS.	File
airport_control_point_feature_class (Optional)	The point features containing an Airport Elevation feature, displaced threshold features, or both. Values provided for the Airport Elevation parameter will take precedence over these point features.	Feature Layer

Derived output

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

Code sample

FAA18B example 1 (stand-alone script)

The following Python script demonstrates how to use the FAA18B function.

import arcpy

# 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 = "VERTICAL_GUIDANCE"
airportElev = 100

# Generate FAA18B OIS
arcpy.aviation.FAA18B(inFeatures,outFeatures, runway, 10, 0, airportElev,
                      "INCLUDE_MERGED_SURFACE")

FAA18B example 2 (stand-alone script)

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

import arcpy

# 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 = "VERTICAL_GUIDANCE"
airportElev = 100
customJSON = r"C:\data\customOIS.json"

# Generate FAA18B OIS
arcpy.aviation.FAA18B(inFeatures,outFeatures, runway, 10, 0, airportElev,
                      "INCLUDE_MERGED_SURFACE", customJSON)

FAA18B example 3 (stand-alone script)

The following Python script demonstrates how to use the FAA18B function with the airport_control_point_feature_class parameter.

import arcpy

# 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 = "VERTICAL_GUIDANCE"
airportElev = 0
customJSON = r"C:\data\customOIS.json"

# Feature class that will contain the Airport Elevation feature
inACPFeatures= r"C:\data\ois.gdb\AirportControlPoint"

# Generate FAA18B OIS
arcpy.aviation.FAA18B(inFeatures,outFeatures, runway, 10, 0, airportElev,
                      "INCLUDE_MERGED_SURFACE", customJSON, inACPFeatures)

Environments

Current Workspace

Licensing information

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

Find a geoprocessing tool

FAA 18B (Aviation Tools)

Summary

Usage

Note:

Parameters

Derived output

Environments

Licensing information

Related topics