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})
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 obstruction identification surfaces. | Feature Layer |
runway_direction (Optional) | Specifies the end of the runway where the approach surface will be created.
| 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
Name | Explanation | Data Type |
derived_outfeatureclass | The updated feature class containing the generated obstruction identification surface. | Feature Layer |
Code sample
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
Licensing information
- Basic: No
- Standard: Requires Airports, ArcGIS Aviation Charting
- Advanced: Requires Airports, ArcGIS Aviation Charting