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.

Parameters

LabelExplanationData 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})
NameExplanationData 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

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

Related topics