Generate Obstacle Features (AllSource Tools)

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.

Label	Explanation	Data type
Input 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
Output Obstacle Features	The output 3D obstacle features.	Feature Class
Output 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

arcpy.intelligence.GenerateObstacleFeatures(in_features, height_field, out_obstacle_features, out_obstacle_buffers, {clip_features})

Name	Explanation	Data type
in_features	The input source features used to create obstacle features.	Feature Layer
height_field	A field from the `in_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 `out_obstacle_features`. Only features within the `clip_features` will be processed.	Feature Layer

Code sample

GenerateObstacleFeatures example 1 (stand-alone script)

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.intelligence.GenerateObstacleFeatures(in_features, h_field, out_obx, out_buf, aoi)

GenerateObstacleFeatures example 2 (Python window)

The following Python window script demonstrates how to use GenerateObstacleFeatures in immediate mode.

import arcpy

arcpy.intelligence.GenerateObstacleFeatures(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

This tool does not use any geoprocessing environments.

Licensing information