This function classifies a raster using a trained classifier. To work correctly, the raster must contain:
- The same attributes in the same order as the classifier.
- The same representation as the examples used to train the classifier.
For instance, if the training example data were normalized, the same normalization must be applied to the raster.
The following diagrams show typical workflows where this function is used:
Example
See the following topics:
Syntax
Result = ENVIClassifyRaster(Input_Raster, Input_Classifier [, Keywords=value])
Return Value
This function returns a reference to a classification ENVIRaster object.
Arguments
Input_Raster
Specify an input ENVIRaster to classify.
Input_Classifier
Specify an input classifier that has been trained, typically output from ENVIGradientDescentTrainer or ENVIIterativeTrainer.
Methods
Close
CreatePyramid
CreateTileIterator
Dehydrate
Export
ExportROIs
GetData
Hydrate
Save
SetData
SetTile
WriteMetadata
Keywords
ERROR (optional)
Set this keyword to a named variable that will contain any error message issued during execution of this routine. If no error occurs, the ERROR variable will be set to a null string (''). If an error occurs and the routine is a function, then the function result will be undefined.
When this keyword is not set and an error occurs, ENVI returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine. See IDL Help for more information on !ERROR_STATE and CATCH.
See Manage Errors for more information on error handling in ENVI programming.
OUTPUT_FILENAME (optional)
Set this keyword to a string with the fully qualified URI for the output classified raster file path. If you do not set this keyword, a temporary file will be created.
Version History
API Version
3.7
See Also
ClassifyRaster Task, ENVISoftmaxRegressionClassifier, ENVISVMClassifier, ENVIRaster