SAGA 9.3.3 | Tool Library Documentation

Point Cloud Reclassifier / Subset Extractor


Description

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, inputINPUTPoint Cloud to reclassify/extract-
Lookup Tabletable, input, optionalRETAB_2Lookup table used in method "user supplied table"-
OutputResultpoint cloud, outputRESULTReclassified 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 point numberOLDValue to reclassify.Default: 0.000000
new valuefloating point numberNEWNew 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 numberMINMinimum value of the range to be reclassified.Default: 0.000000
maximum valuefloating point numberMAXMaximum value of the range to be reclassified.Default: 10.000000
new valuefloating point numberRNEWnew 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 point numberNODATAnew valueDefault: 0.000000
other valuesbooleanOTHEROPTUse this option to reclassify all other values that are not specified in the options above.Default: 0
new valuefloating point numberOTHERSnew valueDefault: 0.000000

Command Line


Usage: saga_cmd pointcloud_tools 6 [-INPUT ] [-ATTRIB ] [-RESULT ] [-MODE ] [-CREATE_ATTRIB ] [-METHOD ] [-OLD ] [-NEW ] [-SOPERATOR ] [-MIN ] [-MAX ] [-RNEW ] [-ROPERATOR ] [-RETAB ] [-TOPERATOR ] [-RETAB_2 ] [-F_MIN ] [-F_MAX ] [-F_CODE ] [-NODATAOPT ] [-NODATA ] [-OTHEROPT ] [-OTHERS ]
  -INPUT:        	Point Cloud
	point cloud, input
  -ATTRIB:       	Attribute
	table field
  -RESULT:       	Result
	point cloud, output
  -MODE:         	Mode of operation
	choice
	Available Choices:
	[0] Reclassify
	[1] Extract Subset
	Default: 0
  -CREATE_ATTRIB:	Create new Attribute
	boolean
	Default: 0
  -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