Point Cloud Reclassifier / Subset Extractor

Author: Volker Wichmann (c) 2009, LASERDATA GmbH
Menu: Shapes | Point Clouds | Tools

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

	Name	Type	Identifier	Description	Constraints
Input	Point Cloud	point cloud, input	`INPUT`	Point Cloud to reclassify/extract	-
Input	Lookup Table	table, input, optional	`RETAB_2`	Lookup table used in method "user supplied table"	-
Output	Result	point cloud, output	`RESULT`	Reclassified or extracted Point Cloud.	-
Options	Attribute	table field	`ATTRIB`	Attribute to process.	-
	Mode of operation	choice	`MODE`	Choose 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 Attribute	boolean	`CREATE_ATTRIB`	Check this to create a new attribute with the reclassification result. If unchecked, the existing attribute is updated.	Default: 0
	Method	choice	`METHOD`	Select 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 value	floating point number	`OLD`	Value to reclassify.	Default: 0.000000
	new value	floating point number	`NEW`	New value.	Default: 1.000000
	operator	choice	`SOPERATOR`	Select 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 value	floating point number	`MIN`	Minimum value of the range to be reclassified.	Default: 0.000000
	maximum value	floating point number	`MAX`	Maximum value of the range to be reclassified.	Default: 10.000000
	new value	floating point number	`RNEW`	new value	Default: 5.000000
	operator	choice	`ROPERATOR`	Select operator: eg. min < value < max.	Available Choices: [0] <= [1] < Default: 0
	Lookup Table	static table	`RETAB`	Lookup 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
	operator	choice	`TOPERATOR`	Select 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 value	table field	`F_MIN`	-	-
	maximum value	table field	`F_MAX`	-	-
	new value	table field	`F_CODE`	-	-
	no data values	boolean	`NODATAOPT`	Use this option to reclassify No-Data values independently of the method settings.	Default: 0
	new value	floating point number	`NODATA`	new value	Default: 0.000000
	other values	boolean	`OTHEROPT`	Use this option to reclassify all other values that are not specified in the options above.	Default: 0
	new value	floating point number	`OTHERS`	new value	Default: 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