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 value must be a multipatch feature class that contains the OIS.

  • The Input Obstacle Features parameter value must be a point, line, or polygon feature class and must be z-enabled with a projected horizontal and vertical coordinate system.

  • The Obstacle Height parameter default value is Feature Geometry, meaning that the height of the obstacle is captured as the z-value. Alternatively, 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 analyses 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.

Parameters

LabelExplanationData 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
Output Obstacle 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
Obstacle Height
(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
(Optional)

Specifies the linear unit that will be used for the obstacle height. This parameter is active if the Obstacle Features parameter is set to Relative height.

  • KilometersThe linear unit will be kilometers.
  • MetersThe linear unit will be meters.
  • DecimetersThe linear unit will be decimeters.
  • CentimetersThe linear unit will be centimeters.
  • MillimetersThe linear unit will be millimeters.
  • Nautical milesThe linear unit will be nautical miles.
  • MilesThe linear unit will be miles.
  • YardsThe linear unit will be yards.
  • FeetThe linear unit will be feet.
  • InchesThe linear unit will be inches.
  • Decimal degreesThe linear unit will be decimal degrees.
  • PointsThe linear unit will be points.
  • UnknownThe linear unit will be unknown.
String
Obstacle Features
(Optional)

Specifies how obstacle height values will be interpreted.

  • Absolute height Obstacle heights will be measured from sea level. This is the default.
  • Relative height Obstacle heights will be measured from ground level.
String
Elevations
(Optional)

Specifies how obstacle base elevation heights will be identified. This parameter is active if the Obstacle Features parameter is set to Relative height.

  • Elevation field Base elevation heights will be derived from a numeric field of the obstacle feature class. This is the default.
  • Elevation DEM Base elevation heights will be derived from one or more DEMs.
String
Elevation Field
(Optional)

The field containing base elevation heights of the obstacle features.

This parameter is active if the Obstacle Features parameter is set to Relative height and the Elevations parameter is set to Elevation field. The default is the first numeric field in the obstacle feature class.

String
Elevation Field Units
(Optional)

Specifies the linear unit that will be used for the base elevation values. This parameter is active if the Obstacle Features parameter is set to Relative height and the Elevations parameter is set to Elevation field.

  • KilometersThe linear unit will be kilometers.
  • MetersThe linear unit will be meters. This is the default.
  • DecimetersThe linear unit will be decimeters.
  • CentimetersThe linear unit will be centimeters.
  • MillimetersThe linear unit will be millimeters.
  • Nautical milesThe linear unit will be nautical miles.
  • MilesThe linear unit will be miles.
  • YardsThe linear unit will be yards.
  • FeetThe linear unit will be feet.
  • InchesThe linear unit will be inches.
  • Decimal degreesThe linear unit will be decimal degrees.
  • PointsThe linear unit will be points.
  • UnknownThe linear unit will be unknown.
String
Input Elevation Model
(Optional)

The DEMs covering the obstacles that will be used to derive base elevation values. This parameter is active if the Obstacle Features parameter is set to Relative height and the Elevations parameter is set to Elevation DEM.

Raster Layer

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})
NameExplanationData 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 that will be used for obstacle height. This parameter is enabled if the height_option parameter is set to RELATIVE_HEIGHT.

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

Specifies how obstacle height values will be interpreted.

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

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

  • ELEVATION_FIELD Base elevation heights will be derived from a numeric field of the obstacle feature class. This is the default.
  • ELEVATION_DEM Base elevation heights will be 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 that will be used for 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 will be kilometers.
  • METERSThe linear unit will be meters. This is the default.
  • DECIMETERSThe linear unit will be decimeters.
  • CENTIMETERSThe linear unit will be centimeters.
  • MILLIMETERSThe linear unit will be millimeters.
  • NAUTICAL_MILESThe linear unit will be nautical miles.
  • MILESThe linear unit will be miles.
  • YARDSThe linear unit will be yards.
  • FEETThe linear unit will be feet.
  • INCHESThe linear unit will be inches.
  • DECIMAL_DEGREESThe linear unit will be decimal degrees.
  • POINTSThe linear unit will be points.
  • UNKNOWNThe linear unit will be unknown.
String
in_dems
[in_dems,...]
(Optional)

The DEMs covering the obstacles that will be 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 function.

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 Obstacle point output 
outFeatures = r"C:\data\ois.gdb\AnalyzeObstacles"

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

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

arcpy.CheckInExtension("Airports")

Environments

Licensing information

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

Related topics