ICAO Annex 14 OFS OES (Aviation)

Available with Aviation Airports license.

Available with Aviation Charting license.

Summary

Creates obstacle-free surfaces (OFS) and obstacle evaluation surfaces (OES) based on ICAO Annex 14 OFS OES specifications. These surfaces define the airspace around aerodromes to be free of obstacles and safeguard airspace so flight operations can be performed safely. This tool creates surfaces as a polygon or multipatch features.

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. The OIS can also be generated in an existing polygon shapefile. If a feature class is used as the Target OIS Features parameter value, it must include a vertical spatial reference.

• To create a .json file for the Custom JSON File parameter, use the CustomizeOIS.exe utility included in the Aviation Airports Product Data download available from My Esri.

• The Airport Elevation parameter has a default value of 0. If you use an elevation value greater than 0, it takes precedence and overrides any existing airport elevation value read from the Input Airport Control Point Feature parameter.

• The Input Airport Control Point Feature parameter can be used to supply x-, y-, and z-geometry for the Airport Elevation parameter, displaced threshold point features, or both. If displaced threshold points are included, surfaces will be constructed based on their x-, y-, and z-geometry instead of their corresponding Input Runway Feature parameter endpoint.

• The horizontal surface generated by this tool will be continuous across the multipatch feature.

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 OIS.	Feature Layer
Surfaces to Generate	Specifies the type of surface that will be generated. Obstacle free surfaces—An OFS will be generated. This provides a free volume of airspace in critical surroundings of the runway. Obstacle evaluation surfaces—An OES will be generated. This provides the volume of airspace where obstacles could impact the operations and where their impact needs to be evaluated.	String
Runway Classification	Specifies the classification of the runway. Non instrument runway—This runway classification is intended for the operation of aircraft using visual approach procedures. Non precision instrument runway—This runway classification is designed for a nonprecision instrument approach procedure. Precision instrument runway—This runway classification is designed for an instrument approach procedure.	String
Airplane Design Group	Specifies the airplane design group that will be used to generate surfaces. I—The airplane design group I will be used. IIA—The airplane design group IIA will be used. IIB—The airplane design group IIB will be used. IIC—The airplane design group IIC will be used. III—The airplane design group III will be used. IV—The airplane design group IV will be used. V—The airplane design group V will be used.	String
Airport Elevation (Optional)	The highest elevation on any of the runways of the airport or reference point. The value must be in the vertical coordinate system linear units of the target feature class. If no value is provided, the highest point from the Input Runway Features parameter value will be used.	Double
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. Both ends—The approach surface will be created at both the low end and the high end of the runway.	String
Include Merged Surfaces (Optional)	Specifies whether merged surfaces will be generated. Checked—All the surfaces will be generated for the merged surfaces, as well as merged conical and horizontal surfaces. This is the default. Unchecked—Surfaces will not be generated for the merged surfaces.	Boolean
Custom JSON File (Optional)	The import configuration, in JSON format, that will be used to create the custom OIS.	File
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
Input Runway (Optional)	The input runway feature layer. The Runway Designator and Width fields will be used to determine the surface dimensions.	Feature Layer
Input Runway End (Optional)	The input runway end feature layer. The Runway Designator and Width fields will be used to determine the surface dimensions.	Feature Layer

Derived Output

Label	Explanation	Data Type
Output OIS Features	The output feature class with the output OIS features.	Feature Layer

Python

arcpy.aviation.ICAOAnnex14OFSOES(in_features, target, surfaces_to_generate, runway_type, airplane_design_group, {airport_elevation}, {runway_direction}, {include_merged_surface}, {custom_json_file}, {airport_control_point_feature_class}, {in_runway_feature_class}, {in_runway_end_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
surfaces_to_generate [surfaces_to_generate,...]	Specifies the type of surface that will be generated. OBSTACLE_FREE_SURFACES—An OFS will be generated. This provides a free volume of airspace in critical surroundings of the runway. OBSTACLE_EVALUATION_SURFACES—An OES will be generated. This provides the volume of airspace where obstacles could impact the operations and where their impact needs to be evaluated.	String
runway_type	Specifies the classification of the runway. NON_INSTRUMENT_RUNWAY—This runway classification is intended for the operation of aircraft using visual approach procedures. NON_PRECISION_INSTRUMENT_RUNWAY—This runway classification is designed for a nonprecision instrument approach procedure. PRECISION_INSTRUMENT_RUNWAY—This runway classification is designed for an instrument approach procedure.	String
airplane_design_group	Specifies the airplane design group that will be used to generate surfaces. I—The airplane design group I will be used. IIA—The airplane design group IIA will be used. IIB—The airplane design group IIB will be used. IIC—The airplane design group IIC will be used. III—The airplane design group III will be used. IV—The airplane design group IV will be used. V—The airplane design group V will be used.	String
airport_elevation (Optional)	The highest elevation on any of the runways of the airport or reference point. The value must be in the vertical coordinate system linear units of the target feature class. If no value is provided, the highest point from the in_features parameter value will be used.	Double
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. BOTH_END—The approach surface will be created at both the low end and the high end of the runway.	String
include_merged_surface (Optional)	Specifies whether merged surfaces will be generated. INCLUDE_MERGED_SURFACE—All the surfaces will be generated for the merged surfaces, as well as merged conical and horizontal surfaces. This is the default. NOT_INCLUDE_MERGED_SURFACE—Surfaces will not be generated for the merged surfaces.	Boolean
custom_json_file (Optional)	The import configuration, in JSON format, that will be used to create the custom OIS.	File
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
in_runway_feature_class (Optional)	The input runway feature layer. The Runway Designator and Width fields will be used to determine the surface dimensions.	Feature Layer
in_runway_end_feature_class (Optional)	The input runway end feature layer. The Runway Designator and Width fields will be used to determine the surface dimensions.	Feature Layer

Derived Output

Name	Explanation	Data Type
derived_outfeatureclass	The output feature class with the output OIS features.	Feature Layer

Code sample

ICAOAnnex14OFSOES example (stand-alone script)

The following Python script demonstrates how to use the ICAOAnnex14OFSOES function.

# Name: ICAOAnnex14OFSOES_sample.py

# Import system modules
import arcpy

# Check out extensions
arcpy.CheckOutExtension('Aeronautical')

#Set the workspace
arcpy.env.workspace = 'c:/data/ois.gdb'

# Set local variables
in_features = 'RunwayCenterline'
target = 'ObstructionIdSurface_MP'
surfaces_to_generate = 'OBSTACLE_FREE_SURFACES'
runway_type = 'NON_INSTRUMENT_RUNWAY'
airplane_design_group = 'I'
airport_elevation = '100'
runway_direction = 'BOTH_END'
include_merged_surface = 'INCLUDE_MERGED_SURFACE'
custom_json_file = 'D:/config.json'
airport_control_point_feature_class = 'AirportControlPoint'

# Call the ICAOAnnex14OFSOES tool
arcpy.aviation.ICAOAnnex14OFSOES(in_features, target, surfaces_to_generate, runway_type,\
                                 airplane_design_group, airport_elevation,\
                                 runway_direction, include_merged_surface,\
                                 custom_json_file, airport_control_point_feature_class)


# Check in extensions
arcpy.CheckInExtension('Aeronautical')

Environments

This tool does not use any geoprocessing environments.

Licensing information

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