This task has been depricated and renamed to RandomizeTrainTensorFlowPixelModel.

This task generates a number of randomized sets of parameter values to train a mask-based TensorFlow model.

This task is part of ENVI Deep Learning, which requires a separate license and installation.

Example


; Start the application
e = ENVI(/HEADLESS)
 
; Get the task from the catalog of ENVITasks
RandomizeModelTask = ENVITask('RandomizeTrainTensorFlowMaskModel')
 
; Define task inputs
RandomizeModelTask.ITERATIONS = 5
 
; Run the task
RandomizeModelTask.Execute
 
; Print the output values for each iteration
Print, 'Blur Distance: ', RandomizeModelTask.OUTPUT_BLUR_DISTANCE
Print, 'Class Weight: ', RandomizeModelTask.OUTPUT_CLASS_WEIGHT
Print, 'Loss Weight: ', RandomizeModelTask.OUTPUT_LOSS_WEIGHT
Print, 'Solid Distance: ', RandomizeModelTask.OUTPUT_SOLID_DISTANCE

Syntax


Result = ENVITask('RandomizeTrainTensorFlowMaskModel')

Input properties (Set, Get): BLUR_DISTANCE, CLASS_WEIGHT, ITERATION, LOSS_WEIGHT, METHOD, SOLID_DISTANCE

Output properties (Get only): OUTPUT_BLUR_DISTANCE, OUTPUT_CLASS_WEIGHT, OUTPUT_LOSS_WEIGHT, OUTPUT_SOLID_DISTANCE

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. See the ENVITask topic in ENVI Help.

  • AddParameter
  • Execute
  • Parameter
  • ParameterNames
  • RemoveParameters

Properties


This task inherits the following properties from ENVITask:

COMMUTE_ON_DOWNSAMPLE

COMMUTE_ON_SUBSET

DESCRIPTION

DISPLAY_NAME

NAME

REVISION

See the ENVITask topic in ENVI Help for details.

This task also contains the following properties:

BLUR_DISTANCE (optional)

Specify a double-precision array with the minimum and maximum distance in pixels to expand positive (non-background) areas beyond the solid distance expansion. The area expanded is blurred, diminishing from the edges of the feature areas to the blur distance. The maximum blur distance is used at the beginning of training and decreased to the minimum blur distance at the end of training. If this value is not set, OUTPUT_BLUR_DISTANCE will be a random value within normal range.

CLASS_WEIGHT (optional)

Specify a double-precision array with the minimum and maximum weights for having a more even balance of classes (including background) during patch selection. Balancing of patch selection is weighted by the maximum value at the beginning of training and decreased to the minimum value at the end of training. In general, set the maximum higher for sparser training sets. The useful range for the maximum value is between 0.0 and 3.0. If this value is not set, OUTPUT_CLASS_WEIGHT will be a random value within normal range.

ITERATION (optional)

Specify the number of sets of parameter values to generate.

LOSS_WEIGHT (optional)

Specify the weight of positive (non-background) pixels when calculating how well the model is fitting the training data. If this value is not set, OUTPUT_LOSS_WEIGHT will be a random value within normal range.

METHOD (required)

Specify a string indicating the method used to randomize the values. The choices are:

  • Random Uniform: produces a uniform distribution of numbers
  • Sobol Sequence (default): produces a non-random list of numbers that does a better job exploring the range of possible values

OUTPUT_BLUR_DISTANCE

A double-precision array with the minimum and maximum distance in pixels to expand positive (non-background) areas beyond the solid distance expansion.

OUTPUT_CLASS_WEIGHT

The double-precision array with the minimum and maximum weights for having a more even balance of classes (including background) when sampling.

OUTPUT_LOSS_WEIGHT

The weight of positive (non-background) pixels when calculating how well the model is fitting the training data.

OUTPUT_SOLID_DISTANCE

The distance in pixels to expand positive (non-background) areas.

SOLID_DISTANCE (optional)

Specify the distance in pixels to expand positive (non-background) areas. If this value is not set, OUTPUT_SOLID_DISTANCE will be a random value within normal range.

Version History


Deep Learning 1.0

Introduced

Deep Learning 1.1

Removed EPOCHS, OUTPUT_EPOCHS, PATCHES_PER_EPOCH, and OUTPUT_PATCHES_PER_EPOCH properties. This is a breaking change to the task since version 1.0.

Deep Learning 3.0 Depricated