ENVIShuffleExamplesTask

This task shuffles the examples and class values from an ENVIExamples object to randomize the order of the examples. Random ordering of the examples is important if the examples are split into multiple sets (such as training and evaluation sets).

The following diagrams show typical workflows where this task is used:

Example

See the following topics for examples:

Syntax

Result = ENVITask('ShuffleExamples')

Input properties (Set, Get): INPUT_EXAMPLES, OUTPUT_EXAMPLES_URI, SEED

Output properties (Get only): OUTPUT_EXAMPLES

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

INPUT_EXAMPLES (required)

Specify an ENVIExamples object.

OUTPUT_EXAMPLES

This is a reference to the shuffled ENVIExamples object.

OUTPUT_EXAMPLES_URI (optional)

Specify a string with the fully qualified filename and path of the output object. If you do not specify this property, the output object (.epo) is only temporary. Once ENVI is closed, it deletes the temporary file. Restore the object later using ENVIRestoreObject.ENVIExamples is a persistable object that can be saved and restored.

SEED (optional)

If repeatability is desired (such as for testing), set this input variable to specify the initial seed value on randomization. See the Seed argument in the IDL RANDOMU help topic for details on its use.

Version History

ENVI 5.4

Introduced

API Version

3.3