Available with Aviation Airports license.
Available with Aviation Charting license.
Summary
Creates obstruction identification surfaces (OIS) based on the ICAO Annex 15 specification (Areas 2a, 2b, and 2c). These surfaces assist in determining the height restriction or removal of obstacles that pose a hazard to air navigation in and around an aerodrome. This tool creates surfaces as a polygon or multipatch features.
Usage
The Input Runway Features parameter must be z-enabled.
This tool creates the OIS in an existing polygon or multipatch feature class. It can also be generated as a new polygon shapefile. A feature class used for the Target OIS Features parameter must include a vertical spatial reference.
To create a JSON file for Custom JSON File, use the CustomizeOIS.exe file that is part of the ArcGIS Aviation data package available from My Esri.
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.
Syntax
ICAOAnnex15(in_features, target, {highend_clear_way_length}, {lowend_clear_way_length}, {custom_json_file})
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 |
highend_clear_way_length (Optional) | The length of the area at the high end of the runway. The unit of measurement is based on the input runway features. | Double |
lowend_clear_way_length (Optional) | The length of the area at the low end of the runway. The unit of measurement is based on the input runway features. | Double |
custom_json_file (Optional) | The import configuration, in JSON format, that creates the custom OIS. | File |
Derived Output
Name | Explanation | Data Type |
derived_outfeatureclass | The updated feature class containing the generated obstruction identification surfaces. | Feature Layer |
Code sample
The following Python window script demonstrates how to use the ICAOAnnex15 tool.
import arcpy
# set gp environment
arcpy.env.workspace = "c:/data/ois.gdb"
arcpy.CheckOutExtension("Aeronautical")
# Input Runway Feature Class
inFeatures = "RunwayCenterline"
# feature class that will contain the OIS surface
outFeatureClass = "ObstructionIdSurface"
# exec ICAOAnnex15
arcpy.ICAOAnnex15_aviation(inFeatures, outFeatureClass, 10, 0)
arcpy.CheckInExtension("Aeronautical")
The following Python window script demonstrates how to use the ICAOAnnex15 tool with the custom_json_file parameter.
import arcpy
# set gp environment
arcpy.env.workspace = "c:/data/ois.gdb"
arcpy.CheckOutExtension("Aeronautical")
# Input Runway Feature Class
inFeatures = "RunwayCenterline"
# feature class that will contain the OIS surface
outFeatureClass = "ObstructionIdSurface"
customJSON = r"C:\data\customOIS.json"
# exec ICAOAnnex15
arcpy.ICAOAnnex15_aviation(inFeatures, outFeatureClass, 10, 0, customJSON)
arcpy.CheckInExtension("Aeronautical")
Environments
Licensing information
- Basic: No
- Standard: Requires Airports, ArcGIS Aviation Charting
- Advanced: Requires Airports, ArcGIS Aviation Charting