ICAO Annex 4 (Aviation Tools)

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 specified for the Target OIS Features parameter value, 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 provide 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.

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 OIS.	Feature Layer
Runway Direction (Optional)	Specifies the end of the runway where 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 OIS.	Feature Layer

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 OIS.	Feature Layer
runway_direction (Optional)	Specifies the end of the runway where 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 OIS.	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

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

Environments

Current Workspace

Licensing information

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