SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Supervised Image Classification

Standard methods for supervised image classification, including minimum distance, maximum likelihood, spectral angle mapping. Classifiers can be trained by areas defined through shapes, samples supplied as table records, or statistics previously stored to file.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputFeaturesGrid list, inputGRIDS--
Training AreasShapes, inputTRAINING--
Training SamplesTable, inputTRAIN_SAMPLESProvide a class identifier in the first field followed by sample data corresponding to the input feature grids.-
OutputClassificationGrid, outputCLASSES--
Look-up Table (*)Table, output, optionalCLASSES_LUTA reference list of the grid values that have been assigned to the training classes.-
Quality (*)Grid, output, optionalQUALITYDependent on chosen method, these are distances or probabilities.-
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
NormalizeBooleanNORMALISE-Default: 0
Colors from FeaturesBoolean, GUIRGB_COLORSUse the first three features in list to obtain blue, green, red components for class colour in look-up table.Default: 0
TrainingChoiceTRAIN_WITH-Available Choices:
[0] training areas
[1] training samples
[2] load from file
Default: 0
Class IdentifierTable fieldTRAINING_CLASS--
Buffer SizeFloating pointTRAIN_BUFFERFor non-polygon type training areas, creates a buffer with a diameter of specified size.Minimum: 0.000000
Default: 1.000000
Load Statistics from File...File pathFILE_LOAD--
Save Statistics to File...File pathFILE_SAVE--
MethodChoiceMETHOD-Available Choices:
[0] Binary Encoding
[1] Parallelepiped
[2] Minimum Distance
[3] Mahalanobis Distance
[4] Maximum Likelihood
[5] Spectral Angle Mapping
Default: 2
Distance ThresholdFloating pointTHRESHOLD_DISTLet pixel stay unclassified, if minimum euclidian or mahalanobis distance is greater than threshold.Minimum: 0.000000
Default: 0.000000
Spectral Angle Threshold (Degree)Floating pointTHRESHOLD_ANGLELet pixel stay unclassified, if spectral angle distance is greater than threshold.Minimum: 0.000000
Maximum: 90.000000
Default: 0.000000
Probability ThresholdFloating pointTHRESHOLD_PROBLet pixel stay unclassified, if maximum likelihood probability value is less than threshold.Minimum: 0.000000
Maximum: 100.000000
Default: 0.000000
Probability ReferenceChoiceRELATIVE_PROB-Available Choices:
[0] absolute
[1] relative
Default: 1
Binary EncodingBooleanWTA_0-Default: 0
ParallelepipedBooleanWTA_1-Default: 0
Minimum DistanceBooleanWTA_2-Default: 0
Mahalanobis DistanceBooleanWTA_3-Default: 0
Maximum LikelihoodBooleanWTA_4-Default: 0
Spectral Angle MappingBooleanWTA_5-Default: 0
(*) optional

Command-line

Usage: saga_cmd imagery_classification 0 [-GRIDS <str>] [-NORMALISE <str>] [-CLASSES <str>] [-CLASSES_LUT <str>] [-QUALITY <str>] [-TRAIN_WITH <str>] [-TRAINING <str>] [-TRAINING_CLASS <str>] [-TRAIN_BUFFER <double>] [-TRAIN_SAMPLES <str>] [-FILE_LOAD <str>] [-FILE_SAVE <str>] [-METHOD <str>] [-THRESHOLD_DIST <double>] [-THRESHOLD_ANGLE <double>] [-THRESHOLD_PROB <double>] [-RELATIVE_PROB <str>] [-WTA_0 <str>] [-WTA_1 <str>] [-WTA_2 <str>] [-WTA_3 <str>] [-WTA_4 <str>] [-WTA_5 <str>]
  -GRIDS:<str>             	Features
	Grid list, input
  -NORMALISE:<str>         	Normalize
	Boolean
	Default: 0
  -CLASSES:<str>           	Classification
	Grid, output
  -CLASSES_LUT:<str>       	Look-up Table
	Table, output, optional
  -QUALITY:<str>           	Quality
	Grid, output, optional
  -TRAIN_WITH:<str>        	Training
	Choice
	Available Choices:
	[0] training areas
	[1] training samples
	[2] load from file
	Default: 0
  -TRAINING:<str>          	Training Areas
	Shapes, input
  -TRAINING_CLASS:<str>    	Class Identifier
	Table field
  -TRAIN_BUFFER:<double>   	Buffer Size
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TRAIN_SAMPLES:<str>     	Training Samples
	Table, input
  -FILE_LOAD:<str>         	Load Statistics from File...
	File path
  -FILE_SAVE:<str>         	Save Statistics to File...
	File path
  -METHOD:<str>            	Method
	Choice
	Available Choices:
	[0] Binary Encoding
	[1] Parallelepiped
	[2] Minimum Distance
	[3] Mahalanobis Distance
	[4] Maximum Likelihood
	[5] Spectral Angle Mapping
	Default: 2
  -THRESHOLD_DIST:<double> 	Distance Threshold
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -THRESHOLD_ANGLE:<double>	Spectral Angle Threshold (Degree)
	Floating point
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 0.000000
  -THRESHOLD_PROB:<double> 	Probability Threshold
	Floating point
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 0.000000
  -RELATIVE_PROB:<str>     	Probability Reference
	Choice
	Available Choices:
	[0] absolute
	[1] relative
	Default: 1
  -WTA_0:<str>             	Binary Encoding
	Boolean
	Default: 0
  -WTA_1:<str>             	Parallelepiped
	Boolean
	Default: 0
  -WTA_2:<str>             	Minimum Distance
	Boolean
	Default: 0
  -WTA_3:<str>             	Mahalanobis Distance
	Boolean
	Default: 0
  -WTA_4:<str>             	Maximum Likelihood
	Boolean
	Default: 0
  -WTA_5:<str>             	Spectral Angle Mapping
	Boolean
	Default: 0