SAGA-GIS Tool Library Documentation (v8.1.0)

Tool Confusion Matrix (Two Grids)

The tool allows one to compare two classified grids. It creates a confusion matrix and derived coefficients as well as the combinations of both classifications as new grid. The values of both grids must match each other in order to do the comparison.
The tool provides three options to define the grid classes:
- by providing a look-up table for each grid
- by coloring each grid with a look-up table (colors type = classified) beforehand (only available in the GUI)
- by preparing the grid values appropriately; i.e., if no look-up table is provided, the tool simply extracts the classes from the grid values found in each grid
A typical application is a change detection analysis based on land cover classification of satellite imagery.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputClassification 1Grid, inputONE--
Look-up Table (*)Table, input, optionalONE_LUT--
Classification 2Grid, inputTWO--
Look-up Table (*)Table, input, optionalTWO_LUT--
OutputCombined ClassesGrid, outputCOMBINED--
Confusion MatrixTable, outputCONFUSION--
Class ValuesTable, outputCLASSES--
SummaryTable, outputSUMMARY--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
ValueTable fieldONE_LUT_MIN--
Value (Maximum) (*)Table fieldONE_LUT_MAX--
Name (*)Table fieldONE_LUT_NAM--
ValueTable fieldTWO_LUT_MIN--
Value (Maximum) (*)Table fieldTWO_LUT_MAX--
Name (*)Table fieldTWO_LUT_NAM--
Report Unchanged ClassesBooleanNOCHANGE-Default: 1
Include Unclassified CellsBooleanNODATA-Default: 1
Output as...ChoiceOUTPUT-Available Choices:
[0] cells
[1] percent
[2] area
Default: 0
(*) optional

Command-line

Usage: saga_cmd imagery_classification 2 [-ONE <str>] [-ONE_LUT <str>] [-ONE_LUT_MIN <str>] [-ONE_LUT_MAX <str>] [-ONE_LUT_NAM <str>] [-TWO <str>] [-TWO_LUT <str>] [-TWO_LUT_MIN <str>] [-TWO_LUT_MAX <str>] [-TWO_LUT_NAM <str>] [-COMBINED <str>] [-NOCHANGE <str>] [-NODATA <str>] [-CONFUSION <str>] [-OUTPUT <str>] [-CLASSES <str>] [-SUMMARY <str>]
  -ONE:<str>        	Classification 1
	Grid, input
  -ONE_LUT:<str>    	Look-up Table
	Table, input, optional
  -ONE_LUT_MIN:<str>	Value
	Table field
  -ONE_LUT_MAX:<str>	Value (Maximum)
	Table field
  -ONE_LUT_NAM:<str>	Name
	Table field
  -TWO:<str>        	Classification 2
	Grid, input
  -TWO_LUT:<str>    	Look-up Table
	Table, input, optional
  -TWO_LUT_MIN:<str>	Value
	Table field
  -TWO_LUT_MAX:<str>	Value (Maximum)
	Table field
  -TWO_LUT_NAM:<str>	Name
	Table field
  -COMBINED:<str>   	Combined Classes
	Grid, output
  -NOCHANGE:<str>   	Report Unchanged Classes
	Boolean
	Default: 1
  -NODATA:<str>     	Include Unclassified Cells
	Boolean
	Default: 1
  -CONFUSION:<str>  	Confusion Matrix
	Table, output
  -OUTPUT:<str>     	Output as...
	Choice
	Available Choices:
	[0] cells
	[1] percent
	[2] area
	Default: 0
  -CLASSES:<str>    	Class Values
	Table, output
  -SUMMARY:<str>    	Summary
	Table, output