PAPI Obstacle Clearance Surface (Aviation)

Available with Aviation Charting license.

Available with Aviation Airports license.

Summary

Creates a Precision Approach Path Indicator (PAPI) Obstacle Clearance Surface (OCS) based on the FAA Engineering Brief (EB) 95.

A PAPI OCS determines which objects are vertical obstructions. An object is considered a vertical obstruction if it penetrates the PAPI OCS. Surfaces are used to support planning and design activities.

Usage

  • The Input Runway Features parameter must be z-enabled.

  • This tool creates the obstruction identification surfaces (OIS)in an existing polygon or multipatch feature class. They 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.

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

  • 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.PAPIObstacleClearanceSurface(in_features, target, {runway_direction}, {length}, {divergence}, {slope}, {distance_from_threshold}, {start_height}, {airport_control_point_feature_class})
ParameterExplanationData 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 obstruction identification surfaces.

Feature Layer
runway_direction
(Optional)

Specifies the end of the runway where the approach surface will be created.

  • HIGH_RUNWAY_END_DESIGNATOR The approach surface will be created at the high end of the runway. This is the default
  • LOW_RUNWAY_END_DESIGNATORThe approach surface will be created at the low end of the runway.
String
length
(Optional)

The length of the surface in miles. The default value is 4.

Double
divergence
(Optional)

The divergence of the surface in degrees. The default value is 10.

Double
slope
(Optional)

The slope of the surface in degrees. The default value is 3.

Double
distance_from_threshold
(Optional)

The distance from the threshold in feet. The default value is 700.

Double
start_height
(Optional)

The start height of the surface in feet. The default value is 35.

Double
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

NameExplanationData Type
derived_outfeatureclass

The updated feature class containing the generated obstruction identification surface.

Feature Layer

Code sample

PAPIObstacleClearanceSurface example (stand-alone script)

The following Python window script demonstrates how to use the PAPIObstacleClearanceSurface tool.

import arcpy

arcpy.CheckOutExtension("Airports")

# 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"

# Define surface dimensions
runway = "HIGH_RUNWAY_END_DESIGNATOR"
length = 4
divergence = 10
slope = 3
distance_from_threshold = 700
start_height = 35

# Generate PAPI Obstacle Clearance Surface
arcpy.PAPIObstacleClearanceSurface_aviation(inFeatures, outFeatures, runway,
                                            length, divergence, slope,
                                            distance_from_threshold, start_height)

arcpy.CheckInExtension("Airports")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics