BuildDeepLearningRaster Task

This task builds a raster than can be used for deep learning purposes, such as classification.

Example

; Start the application

e = ENVI()

; Open an input file

File = Filepath('qb_boulder_msi', Subdir=['data'], $

  Root_Dir=e.Root_Dir)

Raster = e.OpenRaster(File)

; Get the task from the catalog of ENVITasks

Task = ENVITask('BuildDeepLearningRaster')

; Define inputs

Task.INPUT_RASTER = Raster

; Run the task

Task.Execute

; Add the output to the Data Manager

e.Data.Add, Task.OUTPUT_RASTER

; Display the result

View = e.GetView()

Layer = View.CreateLayer(Task.OUTPUT_RASTER)

Layer.QUICK_STRETCH = 'linear'

Syntax

Result = ENVITask('BuildDeepLearningRaster')

Input parameters (Set, Get): ENHANCE_DISPLAY, INPUT_RASTER, INPUT_MODEL, MAX, MIN, OUTPUT_RASTER_URI, VISUAL_RGB

Output parameters (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.

Input Parameters

ENHANCE_DISPLAY (optional)

Specify whether to apply an additional small stretch to the processed data to suppress noise and enhance feature visibility. The optional stretch is effective for improving visual clarity in imagery acquired from aerial platforms or sensors with higher noise profiles.

INPUT_RASTER (required)

Specify the input raster.

INPUT_MODEL (optional)

Specify the ENVIDeepLearningOnnxModel that will be used with this deep learning raster, to assist with band selection.

MAX (optional)

Specify the maximum value to be considered, also known as the white point. If the array has one value, it applies to all bands, otherwise it must have the same number of elements as the input raster has bands. If not set, the maximum value from INPUT_RASTER will be applied to all bands.

MIN (optional)

Specify the minimum value to be considered, also known as the black point. If the array has one value, it applies to all bands, otherwise it must have the same number of elements as the input raster has bands. If not set, the minimum value from INPUT_RASTER will be applied to all bands.

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.

VISUAL_RGB (optional)

Specify whether to encode the output raster as a three-band RGB composite (red, green, blue) for color image processing. This ensures consistent band selection from ENVI display types (such as RGB, CIR, and pan) and supports integration of diverse data sources (such as MSI, panchromatic, and VNIR) without band mismatch.

Output Parameters

OUTPUT_RASTER

This is a reference to the output raster of filetype ENVI and byte data type.

Methods

Execute

Parameter

ParameterNames

See ENVI Help for details on these ENVITask methods.

Properties

DESCRIPTION

DISPLAY_NAME

NAME

REVISION

Version History

Deep Learning 1.0	Introduced
Deep Learning 4.0	Added ENHANCE_DISPLAY and VISUAL_RGB parameters