Label | 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 |
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.
| 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.
| String |
Obstacle Features
(Optional) | Specifies how obstacle height values will be interpreted.
| 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.
| 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.
| 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 |
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.
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
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})
Name | 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.
| 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.
| String |
height_option (Optional) | Specifies how obstacle height values will be interpreted.
| 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.
| 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.
| 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
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: No