ENVISplitExamplesTask

This task splits the examples and class values from an ENVIExamples object into two sets of examples and class values. A common scenario is to use one set for training a classifier and the other set for evaluation. For consistency in both sets, the input examples should be randomized using ENVIShuffleExamplesTask.

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

Example

See the following topics for examples:

Syntax

Result = ENVITask('SplitExamples')

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

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 an array containing two ENVIExamples objects split from the input ENVIExamples.

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.

SPLIT_FRACTION (optional)

Specify the approximate fraction of examples to be designated in the first examples set. The default value is 0.5.

Version History

ENVI 5.4

Introduced

API Version

3.3