Create Curved Approach (Aviation)

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 value must be z-enabled.

    Note:

    Z-values are required to determine the slope and final height of the approach surface.

  • The Input Flight Path Features parameter value must be polyline geometry and include an ObjectID field. The polyline endpoint of the Input Flight Path Features parameter value should be created within a 100 meter search radius of the end point of the Input Runway Features parameter value.

  • The Input Flight Path Features parameter value can be 2D data, because the x and y-values are used to create the direction of the curve.

  • 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 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 the Target OIS Features parameter value is a feature class, it must have a vertical spatial reference.

  • The starting elevation of the curved approach surface will be the same as the runway end elevation.

  • If the PATHID field is included in the Target OIS Features parameter value, it will be populated with the ObjectID value of its source Input Flight Path Feature. This allows Flight Path features to be related to their output curved approach surfaces. The PATHID field (long integer) must first be added to the Target OIS Features parameter value.

  • 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.

Parameters

LabelExplanationData Type
Input Runway Features

The input runway dataset. The feature class must be z-enabled and contain polylines.

Feature Layer
Input Flight Path Features

The polyline features that define curved approaches to the specified runways, terminating at the runway centerline endpoint.

Feature Layer
Target OIS Features

The target feature class that will contain the generated OIS.

Feature Layer
Specification

Specifies the approach surface specification.

  • ICAO Annex 15The approach surface specification is ICAO Annex 15 (ETOD).
  • ICAO Annex 14The approach surface specification is ICAO Annex 14 (OLS).
  • FAA regulations part 77The approach surface specification is FAA regulations part 77 (FAR77).
  • FAA Advisory circular 150/5300_18BThe approach surface specification is FAA Advisory circular 150/5300_18B (18B).
  • FAA Advisory circular 150/5300_13The approach surface specification is FAA Advisory circular 150/5300_13.
String
Runway Classification

The runway classification of the approach surface.

The Specification parameter value will determine the available options for this parameter.

String
Custom JSON File
(Optional)

The import configuration, in JSON format, that will be used to create the custom OIS.

File
Threshold Offset
(Optional)

A positive distance value that will be used to offset the generated approach surface outward from the runway end. The offset will be applied in the units of the input.

Double

Derived Output

LabelExplanationData Type
Output OIS Features

The updated feature class containing the generated OIS.

Feature Layer

arcpy.aviation.CreateCurvedApproach(in_runway_features, in_flightpath_features, target_ois_features, specification, runway_classification, {custom_json_file}, {threshold_offset})
NameExplanationData 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, terminating at the runway centerline endpoint.

Feature Layer
target_ois_features

The target feature class that will contain the generated OIS.

Feature Layer
specification

Specifies the approach surface specification.

  • ETODThe approach surface specification is ICAO Annex 15 (ETOD).
  • OLSThe approach surface specification is ICAO Annex 14 (OLS).
  • FAR77The approach surface specification is FAA regulations part 77 (FAR77).
  • 18BThe approach surface specification is FAA Advisory circular 150/5300_18B (18B).
  • 13SURFACESThe approach surface specification is FAA Advisory circular 150/5300_13.
String
runway_classification

The runway classification of the approach surface.

The specification parameter value will determine the available options for this parameter.

String
custom_json_file
(Optional)

The import configuration, in JSON format, that will be used to create the custom OIS.

File
threshold_offset
(Optional)

A positive distance value that will be used to offset the generated approach surface outward from the runway end. The offset will be applied in the units of the input.

Double

Derived Output

NameExplanationData Type
out_ois_features

The updated feature class containing the generated OIS.

Feature Layer

Code sample

CreateCurvedApproach example (stand-alone script)

The following Python window script demonstrates how to use the CreateCurvedApproach function.

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.aviation.CreateCurvedApproach(inFeatures, inFlightPathFeatures,
                                    outFeatures, specification, runway, customJSON, thresholdOffset)

arcpy.CheckInExtension("Airports")

Environments

Licensing information

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

Related topics