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.

  

• 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})

Parameter	Explanation	Data 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_GEOMETRY —The field containing the height of the obstacle features.	String
unit_field (Optional)	Specifies the linear unit of the obstacle height. KILOMETERS —The linear unit is kilometers. METERS —The linear unit is meters. DECIMETERS —The linear unit is decimeters. CENTIMETERS —The linear unit is centimeters. MILLIMETERS —The linear unit is millimeters. NAUTICAL_MILES —The linear unit is nautical miles. MILES —The linear unit is miles. YARDS —The linear unit is yards. FEET —The linear unit is feet. INCHES —The linear unit is inches. DECIMAL_DEGREES —The linear unit is decimal degrees. POINTS —The linear unit is points. UNKNOWN —The 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. KILOMETERS —The linear unit is kilometers. METERS —The linear unit is meters. This is the default. DECIMETERS —The linear unit is decimeters. CENTIMETERS —The linear unit is centimeters. MILLIMETERS —The linear unit is millimeters. NAUTICAL_MILES —The linear unit is nautical miles. MILES —The linear unit is miles. YARDS —The linear unit is yards. FEET —The linear unit is feet. INCHES —The linear unit is inches. DECIMAL_DEGREES —The linear unit is decimal degrees. POINTS —The linear unit is points. UNKNOWN —The 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

Current Workspace

Licensing information

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