Analyze Runway Obstacles (Aviation)

Available with Aviation Airports license.

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 a point, line, or polygon feature class and must be z-aware.

  • The Obstacle Height parameter will default to Feature Geometry, 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.

  • For Obstacle Features, if Absolute height is chosen, the z-value is calculated from the mean sea level. If Relative height is chosen, the z-value is calculated from the ground level.

  • 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 of the geometry is the altitude of the OIS at the obstacle location.

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

  • The output point features will contain the following fields:

    • Obs_OID—The Object ID of the input obstacle.
    • Z—The Absolute height or the Relative height value of the input obstacle.
    • GROUND_ELEV—If Relative height is chosen, the value of the elevation source of the obstacle. This will be zero if Absolute height is chosen.
    • OIS_Z—The altitude of the OIS at the obstacle location.
    • Delta_Z—The difference in elevation between the top of the obstacle and the OIS.
      Note:

      Positive values indicate obstacle penetration of the OIS.

    • OBSTACLETY—The field value from the input obstacle.

    Delta Z

  • All calculations and analysis are performed using values in the horizontal and vertical coordinate systems of the input OIS feature class. The output feature class is created with those same input OIS feature class coordinate systems.

Syntax

arcpy.aviation.AnalyzeRunwayObstacles(input_ois_features, input_obstacle_features, out_feature_class, {height_field}, {unit_field}, {height_option}, {elevation_option}, {elevation_field}, {elevation_field_unit}, {in_dems})
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. The default value is Feature Geometry.

  • FEATURE_GEOMETRYThe field containing the height of the obstacle features.
String
unit_field
(Optional)

Specifies the linear unit of the obstacle height.

  • KILOMETERSThe linear unit is kilometers.
  • METERSThe linear unit is meters.
  • DECIMETERSThe linear unit is decimeters.
  • CENTIMETERSThe linear unit is centimeters.
  • MILLIMETERSThe linear unit is millimeters.
  • NAUTICAL_MILESThe linear unit is nautical miles.
  • MILESThe linear unit is miles.
  • YARDSThe linear unit is yards.
  • FEETThe linear unit is feet.
  • INCHESThe linear unit is inches.
  • DECIMAL_DEGREESThe linear unit is decimal degrees.
  • POINTSThe linear unit is points.
  • UNKNOWNThe linear unit is unknown.
String
height_option
(Optional)

Specifies how obstacle height values will be interpreted.

  • ABSOLUTE_HEIGHT Obstacle heights are measured from sea level. This is the default.
  • RELATIVE_HEIGHT Obstacle heights are measured from ground level.
String
elevation_option
(Optional)

Specifies how obstacle base elevation heights are identified. This parameter is enabled if the height_option parameter is set to RELATIVE_HEIGHT.

  • ELEVATION_FIELD Base elevation heights are derived from a numeric field of the obstacle feature class. This is the default.
  • ELEVATION_DEM Base elevation heights are derived from one or more DEMs.
String
elevation_field
(Optional)

The field containing base elevation heights of the obstacle features.

This parameter is enabled if the height_option parameter is set to RELATIVE_HEIGHT and the elevation_option parameter is set to ELEVATION_FIELD. The default is the first numeric field in the obstacle feature class.

String
elevation_field_unit
(Optional)

Specifies the linear unit of the base elevation values. This parameter is enabled if the height_option parameter is set to RELATIVE_HEIGHT and the elevation_option parameter is set to ELEVATION_FIELD.

  • KILOMETERSThe linear unit is kilometers.
  • METERSThe linear unit is meters. This is the default.
  • DECIMETERSThe linear unit is decimeters.
  • CENTIMETERSThe linear unit is centimeters.
  • MILLIMETERSThe linear unit is millimeters.
  • NAUTICAL_MILESThe linear unit is nautical miles.
  • MILESThe linear unit is miles.
  • YARDSThe linear unit is yards.
  • FEETThe linear unit is feet.
  • INCHESThe linear unit is inches.
  • DECIMAL_DEGREESThe linear unit is decimal degrees.
  • POINTSThe linear unit is points.
  • UNKNOWNThe linear unit is unknown.
String
in_dems
[in_dems,...]
(Optional)

The DEMs covering the obstacles, used to derive base elevation values. This parameter is enabled if the height_option parameter is set to RELATIVE_HEIGHT and the elevation_option parameter is set to ELEVATION_DEM.

Raster Layer

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.AnalyzeRunwayObstacles_aviation(inOISFeatures, inObstacleFeatures,
                                     outFeatures, heightField)

arcpy.CheckInExtension("Airports")

Environments

Licensing information

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

Related topics