SAGA 9.6.1 | Tool Library Documentation

Reclassify Grid Values


Description

The tool can be used to reclassify the values of a grid. It provides three different options: (a) reclassification of single values (b) reclassification of a range of values (c) reclassification of value ranges specified in a lookup table (simple or user supplied table) In addition to these methods, two special cases (No Data values and values not included in the reclassification setup) are supported. With reclassification mode (a) and (b), the 'No Data' option is evaluated before the 'Method' settings. In reclassification mode (c) the option is evaluated only if the No Data value is not included in the lookup table. The 'Other Values' option is always evaluated after checking the 'Method' settings. The tool also provides options to control the data storage type and No Data value of the output grid.


Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridgrid, inputINPUTGrid to reclassify.-
Lookup Tabletable, input, optionalRETAB_2The lookup table used with method 'user supplied table'.-
OutputReclassified Gridgrid, outputRESULTReclassified grid.-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
MethodchoiceMETHODSelect the desired method: (1) a single value or a range defined by a single value is reclassified, (2) a range of values is reclassified, (3) and (4) a lookup table is used to reclassify the grid.Available Choices: [0] single [1] range [2] simple table [3] user supplied table Default: 0
Old Valuefloating point numberOLDValue to reclassify.Default: 0.000000
New Valuefloating point numberNEWThe value to assign (with method 'single value').Default: 1.000000
OperatorchoiceSOPERATORSelect the desired operator; it is possible to define a range above or below the old value.Available Choices: [0] = [1] < [2] <= [3] >= [4] > Default: 0
Minimum Valuefloating point numberMINThe minimum value of the range to be reclassified.Default: 0.000000
Maximum Valuefloating point numberMAXThe maximum value of the range to be reclassified.Default: 10.000000
New Valuefloating point numberRNEWThe value to assign (with method 'range').Default: 5.000000
OperatorchoiceROPERATORSelect the desired operator (for method 'range'): eg. min < value < max.Available Choices: [0] <= [1] < Default: 0
Lookup Tablestatic tableRETABThe lookup table used with method 'table'.3 Fields: - 1. [8 byte floating point number] minimum - 2. [8 byte floating point number] maximum - 3. [8 byte floating point number] new
OperatorchoiceTOPERATORSelect the desired operator (for method 'table').Available Choices: [0] min <= value < max [1] min <= value <= max [2] min < value <= max [3] min < value < max Default: 0
Minimum Valuetable fieldF_MINThe table field with the minimum value.-
Maximum Valuetable fieldF_MAXThe table field with the maximum value.-
New Valuetable fieldF_CODEThe table field with the value to assign.-
No Data ValuesbooleanNODATAOPTUse this option to reclassify No Data values independently of the method settings.Default: 0
New Valuefloating point numberNODATAThe value to assign to No Data values.Default: 0.000000
Other ValuesbooleanOTHEROPTUse this option to reclassify all values that are not included in the reclassification setup.Default: 0
New Valuefloating point numberOTHERSThe value to assign to all values not included in the reclassification setup.Default: 0.000000
Data Storage Typedata typeRESULT_TYPEThe data storage type of the output grid.Available Choices: [0] bit [1] unsigned 1 byte integer [2] signed 1 byte integer [3] unsigned 2 byte integer [4] signed 2 byte integer [5] unsigned 4 byte integer [6] signed 4 byte integer [7] unsigned 8 byte integer [8] signed 8 byte integer [9] 4 byte floating point number [10] 8 byte floating point number [11] same as first grid in list Default: 11
No Data ValuechoiceRESULT_NODATA_CHOICEChoose how to handle the No Data value of the output grid.Available Choices: [0] No Data value of input grid [1] user defined No Data value [2] No Data value of data storage type Default: 0
No Data Valuefloating point numberRESULT_NODATA_VALUEUser defined No Data value for output grid.Default: -99999.000000

Command Line


Usage: saga_cmd grid_tools 15 [-INPUT ] [-RESULT ] [-METHOD ] [-OLD ] [-NEW ] [-SOPERATOR ] [-MIN ] [-MAX ] [-RNEW ] [-ROPERATOR ] [-RETAB ] [-TOPERATOR ] [-RETAB_2 ] [-F_MIN ] [-F_MAX ] [-F_CODE ] [-NODATAOPT ] [-NODATA ] [-OTHEROPT ] [-OTHERS ] [-RESULT_TYPE ] [-RESULT_NODATA_CHOICE ] [-RESULT_NODATA_VALUE ]
  -INPUT:                 	Grid
	grid, input
  -RESULT:                	Reclassified Grid
	grid, output
  -METHOD:                	Method
	choice
	Available Choices:
	[0] single
	[1] range
	[2] simple table
	[3] user supplied table
	Default: 0
  -OLD:                	Old Value
	floating point number
	Default: 0.000000
  -NEW:                	New Value
	floating point number
	Default: 1.000000
  -SOPERATOR:             	Operator
	choice
	Available Choices:
	[0] =
	[1] <
	[2] <=
	[3] >=
	[4] >
	Default: 0
  -MIN:                	Minimum Value
	floating point number
	Default: 0.000000
  -MAX:                	Maximum Value
	floating point number
	Default: 10.000000
  -RNEW:               	New Value
	floating point number
	Default: 5.000000
  -ROPERATOR:             	Operator
	choice
	Available Choices:
	[0] <=
	[1] <
	Default: 0
  -RETAB:                 	Lookup Table
	static table
	3 Fields:
	- 1. [8 byte floating point number] minimum
	- 2. [8 byte floating point number] maximum
	- 3. [8 byte floating point number] new
	
  -TOPERATOR:             	Operator
	choice
	Available Choices:
	[0] min <= value < max
	[1] min <= value <= max
	[2] min < value <= max
	[3] min < value < max
	Default: 0
  -RETAB_2:               	Lookup Table
	table, input, optional
  -F_MIN:                 	Minimum Value
	table field
  -F_MAX:                 	Maximum Value
	table field
  -F_CODE:                	New Value
	table field
  -NODATAOPT:             	No Data Values
	boolean
	Default: 0
  -NODATA:             	New Value
	floating point number
	Default: 0.000000
  -OTHEROPT:              	Other Values
	boolean
	Default: 0
  -OTHERS:             	New Value
	floating point number
	Default: 0.000000
  -RESULT_TYPE:           	Data Storage Type
	data type
	Available Choices:
	[0] bit
	[1] unsigned 1 byte integer
	[2] signed 1 byte integer
	[3] unsigned 2 byte integer
	[4] signed 2 byte integer
	[5] unsigned 4 byte integer
	[6] signed 4 byte integer
	[7] unsigned 8 byte integer
	[8] signed 8 byte integer
	[9] 4 byte floating point number
	[10] 8 byte floating point number
	[11] same as first grid in list
	Default: 11
  -RESULT_NODATA_CHOICE:  	No Data Value
	choice
	Available Choices:
	[0] No Data value of input grid
	[1] user defined No Data value
	[2] No Data value of data storage type
	Default: 0
  -RESULT_NODATA_VALUE:	No Data Value
	floating point number
	Default: -99999.000000