Available with Aviation Airports license.
Available with Aviation Charting license.
Summary
Creates curved approach obstacle identification surfaces (OIS) based on the supported specifications in ArcGIS Aviation. These curved approach surfaces are based on an input flight path and the information in the selected specification, for example, ICAO Annex 15, FAA 18B and classification. This tool creates surfaces in existing polygon or multipatch features.
Usage
The Input Runway Features parameter must be z-enabled.
The surfaces generated are based on the Specification and Runway Classification parameter values.
The tool creates a curved approach surface in an existing polygon or multipatch feature class. If Output OIS Features is a feature class, it must have a vertical spatial reference.
The tool uses a flight path ID field (PATHID) for Output OIS Features.
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
arcpy.aviation.CreateCurvedApproach(in_runway_features, in_flightpath_features, target_ois_features, specification, runway_classification, {custom_json_file}, {threshold_offset})
Parameter | Explanation | Data Type |
in_runway_features | The input runway dataset. The feature class must be z-enabled and contain polylines. | Feature Layer |
in_flightpath_features | The polyline features that define curved approaches to the specified runways. | Feature Layer |
target_ois_features | The target feature class that will contain the generated OIS. | Feature Layer |
specification | Specifies the approach surface specification.
| String |
runway_classification | The runway classification of the approach surface. The option used for the Specification parameter (specification in Python) will determine the available options for the this parameter. | String |
custom_json_file (Optional) | The import configuration, in JSON format, that creates the custom OIS. | File |
threshold_offset (Optional) | The distance offset from the runway end point. The threshold will be applied in the units of the input. | Double |
Derived Output
Name | Explanation | Data Type |
out_ois_features | The updated feature class containing the generated OIS. | Feature Layer |
Code sample
The following Python window script demonstrates how to use the CreateCurvedApproach tool.
import arcpy
# set gp environment
arcpy.CheckOutExtension("Airports")
# Input Runway Feature Class
inFeatures = r"C:\data\ois.gdb\RunwayCenterline"
# Input Flight Path Feature Class
inFlightPathFeatures= r"C:\data\ois.gdb\TakeOffClimb"
# Feature class that will contain the OIS surface
outFeatures= r"C:\data\ois.gdb\ObstructionIdSurface"
# Speicfication
specification = "FAR77"
# Runway Classification
runway = "PRECISION_INSTRUMENT_RUNWAY"
# JSON
customJSON = r"C:\data\customOIS.json"
# Treshold Offset
thresholdOffset = 0
# Generate FAA 77 OIS
arcpy.CreateCurvedApproach_aviation(inFeatures, inFlightPathFeatures,
outFeatures, specification, runway, customJSON, thresholdOffset)
arcpy.CheckInExtension("Airports")
Environments
Licensing information
- Basic: No
- Standard: Requires Airports, ArcGIS Aviation Charting
- Advanced: Requires Airports, ArcGIS Aviation Charting