ICAO Annex 4 (Aviation)—ArcGIS Pro

Available with Aviation Airports license.

Available with Aviation Charting license.

Summary

Creates obstruction identification surfaces (OIS) based on the ICAO Annex 4 specification for the Precision Approach Terrain chart.

These surfaces are designed to aid in the analysis of the terrain and features within a defined portion of the final approach that is depicted on the Precision Approach Terrain chart type. To generate the surfaces, a runway centerline is needed as a reference for the surfaces. This tool generates the surfaces as polygon or multipatch features.

Usage

The Input Runway Features parameter must be z-enabled.
The Target OIS Features parameter must be z-enabled.
If a feature class is selected in 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.ICAOAnnex4(in_features, target, {runway_direction}, {length}, {width}, {slope}, {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 at which end of the runway the approach surface will be created. HIGH_END_TO_LOW_END —From runway high end to low end. The approach surface will be created at the high end of the runway. If a displaced threshold point exists at the high end of the runway, that point will be honored when creating the OIS. LOW_END_TO_HIGH_END —From runway low end to high end. The approach surface will be created at the low end of the runway. If a displaced threshold point exists at the low end of the runway, that point will be honored when creating the OIS.	String
length (Optional)	The length of the surface in meters. The default value is 900.	Double
width (Optional)	The width of the surface in meters. The default value is 120.	Double
slope (Optional)	The slope of the surface in degrees. The default value is 3.	Double
height (Optional)	The start height of the surface in meters. The default value is 15.24.	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 surfaces.	Feature Layer

Code sample

ICAOAnnex4 example (Python window)

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

import arcpy

# set gp environment
arcpy.env.workspace = "c:/data/ois.gdb"
arcpy.CheckOutExtension("Airports")

# Input Runway Feature Class
inFeatures = "RunwayCenterline"

# feature class that will contain the OIS surface
outFeatureClass = "ObstructionIdSurface"

# runway variables
runwayDir = "HIGH_END_TO_LOW_END"
length = 900
width = 120
slope = 3
start_height = 15.24

#_Exec_ICAOAnnex4
arcpy.ICAOAnnex4_aviation(inFeatures, outFeatureClass, runwayDir, length, width, slope, start_height)

arcpy.CheckInExtension("Airports")

Environments

Current Workspace

Licensing information

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