Summary
Creates obstruction identification surfaces based on the FAA FAR 77 specification. These surfaces describe airspace segments that are clear of obstructions. The type, function, and dimension of a surface differs by runway classification. This tool creates surfaces as polygon or multipatch features, or triangulated irregular networks (TINs).
Usage
The Input Runway Features parameter must be z-enabled.
The selection you make in High Runway Designator Classification and Low Runway Designator Classification will automatically populate most of the surface parameters.
This tool creates the OIS in an existing polygon or multipatch feature class. It can also be generated as a new TIN or polygon shapefile. If a feature class is selected for Output Features, it must have a vertical spatial reference.
For military airports, the outer horizontal surface is merged as well as the horizontal and conical surfaces.
Syntax
arcpy.aviationois.FAAFAR77(in_features, high_runway_end_type, low_runway_end_type, specially_prepared_hard_surface_runway, highend_clear_way_length, lowend_clear_way_length, airport_elevation, include_merged_surface, out_features)
Parameter | Explanation | Data Type |
in_features | The input runway dataset. The feature class must be z-enabled and contain points, polylines, or polygons. | Feature Layer |
high_runway_end_type | The classification of the high end of the runway.
| String |
low_runway_end_type | The classification of the low end of the runway.
| String |
specially_prepared_hard_surface_runway | A specially prepared hard surface indicates that the primary surface extends 200 feet beyond each end of the runway.
| Boolean |
highend_clear_way_length | The length of the area at the high end of the runway, in feet. An aircraft can make a portion of its initial climb over this area. | Double |
lowend_clear_way_length | The length of the area at the low end of the runway, in feet. An aircraft can make a portion of its initial climb over this area. | Double |
airport_elevation | The highest point on any runway in an airport, in feet. The units for elevation are based on the specification. The tool will automatically populate this value from a z-value in your aeronautical database if you are using the AIS or Airports data model. Airport elevation is stored in the z-value of the ADHP point feature class in the AIS data model. In the Airports data model, elevation is stored in the z-value of the Airport Control Point feature class for records with the Point_Type field populated with AIRPORT_ELEVATION. | Double |
include_merged_surface | Indicates whether merged horizontal and conical surfaces are included in the OIS, in addition to the regular surfaces.
| Boolean |
out_features | The output feature class or TIN that will contain the generated obstacle identification surfaces. | Feature Layer; Folder |
Code sample
FAAFAR77 example (stand-alone Python script)
The following Python window script demonstrates how to use the FAAFAR77 function.
import arcpy
# set gp environment
arcpy.env.workspace="c:/data/ois.gdb"
arcpy.CheckOutExtension("Aeronautical")
# Input Runway Feature Class
inFeatures = "RunwayCenterline"
# feature class that will contain the OIS surface
outFeatures="ObstructionIdSurface"
# runway variables
hiEndRunway = "Precision Instrument Runway"
lowEndRunway = "Precision Instrument Runway"
hardSurfaceRunway="SPECIALLY_PREPARED_HARD_SURFACE_RUNWAY"
hiEndClearWay=0
lowEndClearWay=0
airportElev = 0
# execute the tool
arcpy.FAAFAR77_aviationois(inFeatures,hiEndRunway,lowEndRunway,hardSurfaceRunway,
hiEndClearWay,lowEndClearWay,airportElev,
"INCLUDE_MERGED_SURFACE",outFeatures)
arcpy.CheckInExtension("Aeronautical")
Environments
Licensing information
- Basic: No
- Standard: Requires Airports or Aviation Charting
- Advanced: Requires Airports or Aviation Charting