Generate Obstacle Features (Intelligence)

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

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.GenerateObstacleFeatures_intelligence(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.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

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Requires 3D Analyst and Spatial Analyst
  • Standard: Requires 3D Analyst and Spatial Analyst
  • Advanced: Requires 3D Analyst and Spatial Analyst

Related topics