SAGA 9.7.1 | Tool Library Documentation

Point Cloud Reclassifier / Subset Extractor

Description

The tool can be used to either reclassify a Point Cloud attribute, to extract, or drop a subset of a Point Cloud based on the values of an attribute. The tool provides three different methods for selection of points to become reclassified/extracted/deleted:

  1. single value
  2. value range
  3. 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. Have in mind that subset deletion will be performed on the input point cloud!

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 [2] Drop 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
Selection 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 value [1] value range [2] simple table [3] user supplied table Default: 0
Valuefloating point numberOLDValue to reclassify, extract or drop.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] > [5] <> 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] minimum <= value <= maximum [1] minimum < value < maximum [2] value < minimum or value > maximum [3] value <= minimum or value >= maximum 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] minimum <= value < maximum [1] minimum <= value <= maximum [2] minimum < value <= maximum [3] minimum < value < maximum 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
	[2] Drop Subset
	Default: 0
  -CREATE_ATTRIB:	Create new Attribute
	boolean
	Default: 0
  -METHOD:       	Selection Method
	choice
	Available Choices:
	[0] single value
	[1] value range
	[2] simple table
	[3] user supplied table
	Default: 0
  -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] >
	[5] <>
	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] minimum <= value <= maximum
	[1] minimum < value < maximum
	[2] value < minimum or value > maximum
	[3] value <= minimum or value >= maximum
	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] minimum <= value < maximum
	[1] minimum <= value <= maximum
	[2] minimum < value <= maximum
	[3] minimum < value < maximum
	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