Summary
Converts features with a height field to a 3D obstacle feature and an obstacle restriction buffer for use in evaluating helicopter landing zones.
Usage
The tool is used to convert generic features to obstacle features and feature buffers and can be used to process several obstruction formats before using the Generate HLZ Suitability tool.
Height Field can be a numeric field or a text field. Text fields are internally converted to numeric values. However, if a text field's value includes any nonnumeric characters, the tool will fail. If you're using a text field, review the data before using the tool.
Output Obstacle Features will be 3D point features with an Obstacle Approach/Departure Distance field.
Output Obstacle Buffers are created by buffering the Output Obstacle Features using the Obstacle Approach/Departure Distance field.
Syntax
arcpy.intelligence.GenerateObstacleFeatures(in_features, height_field, out_obstacle_features, out_obstacle_buffers, {clip_features})
Parameter | Explanation | Data Type |
in_features | The input source features used to create obstacle features. | Feature Layer |
height_field | A field from the Input Features parameter containing height values. The field type can be numeric or text. If a text field is used, the field values must be numeric. | Field |
out_obstacle_features | The output 3D obstacle features. | Feature Class |
out_obstacle_buffers | The output obstacle buffer features | Feature Class |
clip_features (Optional) | An area to clip the Output Obstacle Features. Only features within the Clip Features will be processed. | Feature Layer |
Code sample
The following Python script demonstrates how to use GenerateObstacleFeatures in a stand-alone script.
import os
import arcpy
working_mty = r"d:\working\monterey"
in_features = os.path.join(working_mty, "tasking.gdb", "MontereyDV")
h_field = "AGL"
out_obx = os.path.join(working_mty, "results.gdb", "obstacles")
out_buf = os.path.join(working_mty, "results.gdb", "buffers")
aoi = os.path.join(working_mty, "tasking.gdb", "mtyAOI")
arcpy.GenerateObstacleFeatures_intelligence(in_features, h_field, out_obx, out_buf, aoi)
The following Python window script demonstrates how to use GenerateObstacleFeatures in immediate mode.
import arcpy
arcpy.GenerateObstacleFeatures_intelligence(r"d:\working\monterey\tasking.gdb\MontereyDV",
"AGL",
r"d:\working\monterey\results.gdb\obstacles",
r"d:\working\monterey\results.gdb\buffers",
r"d:\working\monterey\tasking.gdb\mtyAOI")
Environments
Licensing information
- Basic: Requires 3D Analyst and Spatial Analyst
- Standard: Requires 3D Analyst and Spatial Analyst
- Advanced: Requires 3D Analyst and Spatial Analyst