Skip To Content

Analyze Runway Obstacles

Summary

Analyzes obstacle data and obstruction identification surfaces (OIS) to determine if obstacles are penetrating.

Usage

  • The Input OIS Features parameter must be a multipatch feature class that contains the OIS.

  • The Input Obstacle Features parameter must be either a point, line, or polygon feature class and must be z-aware.

  • The Obstacle Height parameter will default to Z(AGL), meaning it assumes that the height of the obstacle is captured as the z-value. Otherwise, you can specify a field in the feature class that contains the height values.

    Note:

    If a field is specified for the Obstacle Height parameter, the tool will assume that the feature's z-value represents the elevation. The tool will then add that value and the height field value together in order to perform the analysis.

  • A point feature is generated for each obstacle feature that falls within the area covered by the OIS. The x- and y-point coordinates are the same as the obstacle point feature with which the output point is associated.

  • Multipoint features will be generated when the input obstacle data is a polyline or a polygon.

    Note:

    The output point features will contain the z-values for the obstacles, as well as the negative and positive delta values for each feature.

    The values in the Z field represent the z-value at the obstruction surface level. The Delta_Z field value is the difference between the OIS and the top of the obstacle. When analyzing polygon obstacle features, vertices without any known z-value that intersect areas between the OIS and an obstacle will be assigned the highest z-value within the obstacle feature.

    Delta Z

Syntax

AnalyzeRunwayObstacles(input_ois_features, input_obstacle_features, out_feature_class, {height_field}, {unit_field})
ParameterExplanationData Type
input_ois_features

The multipatch features with defined Airport schema. The feature class must be z-enabled.

Feature Layer
input_obstacle_features

The input obstacle features that will be analyzed. The feature class must be z-enabled.

Feature Layer
out_feature_class

A feature class containing one point for each obstacle feature that falls within the area covered by the input OIS. If the geometry type of the input obstacle feature is a polyline or polygon, a multipoint feature class will be created.

Feature Class
height_field
(Optional)

The field containing the height of the obstacle features. Default value is Z(AGL).

String
unit_field
(Optional)

The linear unit of the obstacle height.

  • KILOMETERSKilometers
  • METERSMeters
  • DECIMETERSDecimeters
  • CENTIMETERSCentimeters
  • MILLIMETERSMillimeters
  • NAUTICAL_MILESNautical miles
  • MILESMiles
  • YARDSYards
  • FEETFeet
  • INCHESInches
  • DECIMAL_DEGREESDecimal degrees
  • POINTSPoints
  • UNKNOWNUnknown
String

Code sample

AnalyzeRunwayObstacles example (stand-alone script)

The following Python window script demonstrates how to use the AnalyzeRunwayObstacles tool.

import arcpy

# set gp environment
arcpy.CheckOutExtension("Airports")

# Input Obstruction Identification Surface Feature Class
inOISFeatures = r"C:\data\ois.gdb\ObstructionIdSurface"

# Input Obstruction Data
inObstacleFeatures = r"C:\data\ois.gdb\Obstacle"

# Feature class that will contain the OIS surface
outFeatures = r"C:\data\ois.gdb\AnalyzeObstacles"

# Height field variables
heightField = "Z(AGL)"

# Processing AnalyzeRunwayObstacles
arcpy.AnalyzeRuwayObstacles_aviation(inOISFeatures, inObstacleFeatures,
                                     outFeatures, heightField)

arcpy.CheckInExtension("Airports")

Environments

Licensing information

  • Basic: No
  • Standard: Requires Aviation Airports
  • Advanced: Requires Aviation Airports

Related topics