HelicopterLandingZones Task

This task performs raster identification of helicopter landing zones.

For additional details on helicopter landing zones, see Helicopter Landing Zones.

Example

; Start the application

e = ENVI()

; Open an input point cloud file

File = Filepath(DataSample.las', $

  SUBDIRECTORY=['data','lidar'], $

  ROOT_DIR=e.ROOT_DIR)

pointCloud = e.OpenPointCloud(File, $

  PROJECT_URI=e.GetTemporaryFilename(''))

; Use the point cloud feature extraction task to generate

; a digital surface model (DSM) from the point cloud

dsmTask = ENVITask('PointCloudFeatureExtraction')

dsmTask.INPUT_POINT_CLOUD = pointCloud

dsmTask.DSM_GENERATE = 1

dsmTask.Execute

; Open the resulting DSM raster and close the point cloud object

dsmRaster = e.OpenRaster(dsmTask.OUTPUT_PRODUCTS_INFO.DSM_URI)

pointCloud.Close

; Get the helicopter landing zones task from the catalog of ENVITasks

hlzTask = ENVITask('HelicopterLandingZones')

; Define the input raster

hlzTask.INPUT_RASTER = dsmRaster

; Run the task

hlzTask.Execute

; Get the collection of data objects currently available in the Data Manager

DataColl = e.Data

; Add the output to the Data Manager

DataColl.Add, hlzTask.OUTPUT_RASTER

; Display the result

View = e.GetView()

Layer = View.CreateLayer(hlzTask.OUTPUT_RASTER)

Syntax

Result = ENVITask('HelicopterLandingZones')

Input properties (Set, Get): HELO_SIZE, HELO_TYPE, HOVER_HEIGHT, INPUT_RASTER, LANDING_GEAR, OPERATING_CONDITIONS, OUTPUT_RASTER_URI, USE_HOVER, ZONE_SIZE

Output properties (Get only): OUTPUT_RASTER

Properties marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time. Properties marked as "Get" are those whose values you can retrieve but not set.

Methods

This task inherits the following methods from ENVITask:

Properties

This task inherits the following properties from ENVITask:

COMMUTE_ON_DOWNSAMPLE

HELO_SIZE (optional)

Specify the size of the helicopter in meters. This property is only used if HELO_TYPE is set to User-Defined. The default value is 15.

HELO_TYPE (optional)

Specify the type of helicopter. The following values are allowed:

User-Defined: Permits custom user input. If selected, use the HELO_SIZE and ZONE_SIZE properties to set the landing zone parameters.
Light Observation: Includes helicopters such as the OH-6 Little Bird and the OH-58 Kiowa.
Light Utility: Includes helicopters such as the UH-1 Iroquois "Huey", the AH-1 Cobra, and the H-65 Dolphin.
Medium Utility: Includes helicopters such as the AH-64 Apache, the UH-60 Blackhawk, and the H-2 Seasprite.
Cargo: Includes helicopters such as the CH-47 Chinook, the CH-53 Sea Stallion, and the H-3 Sea King.
Slingload: For helicopter operations using a slingload.
Slingload Long-line: For helicopter operations using a long-line slingload.
Slingload with NVGs: For helicopter operations using a slingload with night vision goggles (NVGs).

The default value is Medium Utility.

HOVER_HEIGHT (optional)

Specify the hovering height in meters. This property is only used if USE_HOVER is set to 1. The default value is 3.

INPUT_RASTER (required)

Specify a digital surface model raster with which to identify helicopter landing zones.

LANDING_GEAR (optional)

Specify the type of landing gear used by the helicopter, Skidsor Wheels. The default value is Wheels.

OPERATING_CONDITIONS (optional)

Specify the operating conditions for the helicopter landing zone. Allowed values are Day, Day (permissive), and Night. The default value is Day.

OUTPUT_RASTER

This is a reference to the output raster of filetype ENVI.

OUTPUT_RASTER_URI (optional)

Specify a string with the fully qualified filename and path of the associated OUTPUT_RASTER. If you do not specify this property, or set it to an exclamation symbol (!), a temporary file will be created.

USE_HOVER (optional)

Specify whether to allow the helicopter to hover over the landing zone. The default value is 0.

ZONE_SIZE (optional)

Specify the size of the landing zone in meters. This property is only used if HELO_TYPE is set to User-Defined. The default value is 100.

Version History

ENVI 6.1

Introduced

API Version

4.3