Skip To Content

Analyze Runway Obstacles


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


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


    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.


    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


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

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

Feature Layer

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

Feature Layer

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

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


The linear unit of the obstacle height.

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

Code sample

AnalyzeRunwayObstacles example (stand-alone script)

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

import arcpy

# set gp environment

# 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)



Licensing information

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

Related topics