ICAO Annex 4 (Aviation)

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.

Legacy:

This is a deprecated tool. This functionality has been replaced by the ICAO Annex 4 Surfaces tool that creates OIS based on the ICAO Annex 4 specification for the Precision Approach Terrain chart with updated requirements and parameters.

Usage

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

• The Target OIS Features parameter value 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.

Parameters

Dialog

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 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—The approach surface will be created at the high end of the runway to the low end. 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—The approach surface will be created at the low end of the runway to the high end. 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
Start Height (Optional)	The start height of the surface in meters. The default value is 15.24.	Double
Input Airport Control Point Feature (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

Label	Explanation	Data Type
Output OIS Features	The updated feature class containing the generated obstruction identification surfaces.	Feature Layer

Python

arcpy.aviation.ICAOAnnex4(in_features, target, {runway_direction}, {length}, {width}, {slope}, {height}, {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 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—The approach surface will be created at the high end of the runway to the low end. 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—The approach surface will be created at the low end of the runway to the high end. 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 function.

# set gp environment
import arcpy

# Check out extensions
arcpy.CheckOutExtension(Airports)

# Set local variables
in_features = r"C:\data\ois.gdb\RunwayCenterline"
target_ois_features = r"C:\data\ois.gdb\ObstructionIdSurface"
surface_generation = "TAKEOFF_FLIGHT_PATH_AREA"
runway_direction = "HIGH_END_TO_LOW_END"
clear_way_length="900"
threshold_point_feature_class = r"C:\data\ois.gdb\AirportControlPoint"
custom_json_file = r"C:\data\customOIS.json"

# Run the ICAOAnnex4Surfaces tool 
arcpy.aviation.ICAOAnnex4Surfaces(in_features, target_ois_features, surface_generation, runway_direction, clear_way_length,
 threshold_point_feature_class, custom_json_file)

#Check in extensions
arcpy.CheckInExtension(Airports)

Environments

Current Workspace

Licensing information

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