Skip To Content

Analyze Runway Obstacles

Summary

Examines Obstruction Identification Surfaces (OIS) with obstacle data to determine and analyze how far the obstacles intersect an OIS.

Usage

  • The Input OIS Features must be z-enabled.

  • Using a multipatch feature class generated by the Analyze Runway Obstacles tool is recommended with all defined attributes populated in the Airport schema.

  • The input obstruction data must be z-enabled.

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

  • The z-value is calculated based on the OIS. If an obstacle height value is specified for the OIS points, the z-value is the sum of the field values.

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

Syntax

AnalyzeRunwayObstacles_aviation (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 feature.

String
unit_field
(Optional)

The unit of the obstacle height.

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("Aeronautical")

# 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("Aeronautical")

Environments

Licensing information

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

Related topics