SAGA-GIS Tool Library Documentation (v7.3.0)

Tool Point Cloud Reclassifier / Subset Extractor

The tool can be used to either reclassify a Point Cloud attribute or to extract a subset of a Point Cloud based on the values of an attribute.

The tool provides three different options:
(a) reclassification of (or extraction based on) single values,
(b) reclassification of (or extraction based on) a range of values and
(c) reclassification of (or extraction based on) value ranges specified in a lookup table.

Each of these three options provides it's own parameters. The 'new value' parameters are irrelevant in case a subset is extracted.

In addition to these settings, two special cases ('NoData values' and 'other values' not included in the parameter setup) are supported:
In mode (a) and (b) the 'NoData option' is evaluated before the method settings, in mode (c) the option is evaluated only if the NoData value isn't included in the lookup table.
The 'other values' option is always evaluated after checking the method settings.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputPoint CloudPoint Cloud (input)INPUTPoint Cloud to reclassify/extract-
Lookup Table (*)Table (optional input)RETAB_2Lookup table used in method "user supplied table"-
OutputResultPoint Cloud (output)RESULTReclassified or extracted Point Cloud.-
OptionsAttributeTable fieldATTRIBAttribute to process.-
Mode of operationChoiceMODEChoose whether to reclassify a Point Cloud or to extract a subset from a Point Cloud.Available Choices:
[0] Reclassify
[1] Extract Subset
Default: 0
Create new AttributeBooleanCREATE_ATTRIBCheck this to create a new attribute with the reclassification result. If unchecked, the existing attribute is updated.Default: 0
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. the 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 pointOLDValue to reclassify.Default: 0.000000
new valueFloating pointNEWNew 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 pointMINMinimum value of the range to be reclassified.Default: 0.000000
maximum valueFloating pointMAXMaximum value of the range to be reclassified.Default: 10.000000
new valueFloating pointRNEWnew valueDefault: 5.000000
operatorChoiceROPERATORSelect operator: eg. min < value < max.Available Choices:
[0] <=
[1] <
Default: 0
Lookup TableStatic tableRETABLookup table used in 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 (min < value < max; min . value < max; min .value . max; min < value . max).Available Choices:
[0] min <= value < max
[1] min <= value <= max
[2] min < value <= max
[3] min < value < max
Default: 0
minimum valueTable fieldF_MIN--
maximum valueTable fieldF_MAX--
new valueTable fieldF_CODE--
no data valuesBooleanNODATAOPTUse this option to reclassify No-Data values independently of the method settings.Default: 0
new valueFloating pointNODATAnew valueDefault: 0.000000
other valuesBooleanOTHEROPTUse this option to reclassify all other values that are not specified in the options above.Default: 0
new valueFloating pointOTHERSnew valueDefault: 0.000000
(*) optional

Command-line

Usage: saga_cmd pointcloud_tools 6 [-INPUT <str>] [-ATTRIB <str>] [-RESULT <str>] [-MODE <str>] [-CREATE_ATTRIB <str>] [-METHOD <str>] [-OLD <double>] [-NEW <double>] [-SOPERATOR <str>] [-MIN <double>] [-MAX <double>] [-RNEW <double>] [-ROPERATOR <str>] [-RETAB <str>] [-TOPERATOR <str>] [-RETAB_2 <str>] [-F_MIN <str>] [-F_MAX <str>] [-F_CODE <str>] [-NODATAOPT <str>] [-NODATA <double>] [-OTHEROPT <str>] [-OTHERS <double>]
  -INPUT:<str>        	Point Cloud
	Point Cloud (input)
  -ATTRIB:<str>       	Attribute
	Table field
  -RESULT:<str>       	Result
	Point Cloud (output)
  -MODE:<str>         	Mode of operation
	Choice
	Available Choices:
	[0] Reclassify
	[1] Extract Subset
	Default: 0
  -CREATE_ATTRIB:<str>	Create new Attribute
	Boolean
	Default: 0
  -METHOD:<str>       	Method
	Choice
	Available Choices:
	[0] single
	[1] range
	[2] simple table
	[3] user supplied table
	Default: 0
  -OLD:<double>       	old value
	Floating point
	Default: 0.000000
  -NEW:<double>       	new value
	Floating point
	Default: 1.000000
  -SOPERATOR:<str>    	operator
	Choice
	Available Choices:
	[0] =
	[1] <
	[2] <=
	[3] >=
	[4] >
	Default: 0
  -MIN:<double>       	minimum value
	Floating point
	Default: 0.000000
  -MAX:<double>       	maximum value
	Floating point
	Default: 10.000000
  -RNEW:<double>      	new value
	Floating point
	Default: 5.000000
  -ROPERATOR:<str>    	operator
	Choice
	Available Choices:
	[0] <=
	[1] <
	Default: 0
  -RETAB:<str>        	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:<str>    	operator
	Choice
	Available Choices:
	[0] min <= value < max
	[1] min <= value <= max
	[2] min < value <= max
	[3] min < value < max
	Default: 0
  -RETAB_2:<str>      	Lookup Table
	Table (optional input)
  -F_MIN:<str>        	minimum value
	Table field
  -F_MAX:<str>        	maximum value
	Table field
  -F_CODE:<str>       	new value
	Table field
  -NODATAOPT:<str>    	no data values
	Boolean
	Default: 0
  -NODATA:<double>    	new value
	Floating point
	Default: 0.000000
  -OTHEROPT:<str>     	other values
	Boolean
	Default: 0
  -OTHERS:<double>    	new value
	Floating point
	Default: 0.000000