SAGA 9.3.3 | Tool Library Documentation

Get Subset from Virtual Point Cloud


Description

The tool allows one to retrieve a point cloud from a virtual point cloud dataset by dragging a box (AOI) in a Map View. Optionally, the query can be constrained by providing an attribute field and a value range that must be met. A virtual point cloud dataset is a simple XML format with the file extension .spcvf, which can be created with the 'Create Virtual Point Cloud Dataset' tool.


Parameters

 NameTypeIdentifierDescriptionConstraints
OutputPoint Clouddata object Point Cloud, output, optionalPC_OUTThe output point cloud-
OptionsFilenamefile pathFILENAMEThe full path and name of the .spcvf file-
Copy existing AttributesbooleanCOPY_ATTRCopy attributes from input to output point cloud.Default: 1
Copy AttributestextATTRIBUTE_LISTField numbers (starting from 1) of the attributes to copy, separated by semicolon; fields one to three (x;y;z) are mandatory.Default: 1;2;3
Constrain QuerybooleanCONSTRAIN_QUERYCheck this parameter to constrain the query by an attribute range.Default: 0
Attribute Fieldinteger numberATTR_FIELDThe attribute field to use as constraint. Field numbers start with 1.Minimum: 1 Default: 1
Value Rangevalue rangeVALUE_RANGEMinimum and maximum of attribute range [].-

Command Line


Usage: saga_cmd io_virtual 3 [-FILENAME ] [-PC_OUT ] [-COPY_ATTR ] [-ATTRIBUTE_LIST ] [-CONSTRAIN_QUERY ] [-ATTR_FIELD ] [-VALUE_RANGE_MIN ] [-VALUE_RANGE_MAX ]
  -FILENAME:          	Filename
	file path
  -PC_OUT:            	Point Cloud
	data object Point Cloud, output, optional
  -COPY_ATTR:         	Copy existing Attributes
	boolean
	Default: 1
  -ATTRIBUTE_LIST:    	Copy Attributes
	text
	Default: 1;2;3
  -CONSTRAIN_QUERY:   	Constrain Query
	boolean
	Default: 0
  -ATTR_FIELD:        	Attribute Field
	integer number
	Minimum: 1
	Default: 1
  -VALUE_RANGE_MIN:	Value Range
	value range
  -VALUE_RANGE_MAX:	Value Range
	value range