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

LabelExplanationData 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 endThe 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 endThe 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

LabelExplanationData Type
Output OIS Features

The updated feature class containing the generated obstruction identification surfaces.

Feature Layer

arcpy.aviation.ICAOAnnex4(in_features, target, {runway_direction}, {length}, {width}, {slope}, {height}, {airport_control_point_feature_class})
NameExplanationData 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_ENDThe 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_ENDThe 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

NameExplanationData 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

Licensing information

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