SAGA-GIS Module Library Documentation (v2.1.3)

Module Get Subset from Virtual Point Cloud

The module allows to retrieve a point cloud from a virtual point cloud dataset by applying the provided area-of-interest (AOI). The extent of the AOI can be provided either as polygon shapefile, grid or by coordinates. Optionally, an overlap can be added to the AOI. In case an overlap is used and the AOI is provided as polygon shapfile, only the bounding boxes of the polygons are used.
With polygon shapefiles additional functionality is available:
* in case one or more polygons are selected, only the selected polygons are used.
* in case the shapefile contains several polygons and the 'One Point Cloud per Polygon' parameter is checked, a point cloud dataset is outputted for each polygon. In case the 'Tilename' attribute is provided, the output files are named by this attribute. Otherwise the output file names are build from the lower left coordinate of each tile.
The derived datasets can be outputted either as point cloud list or written to an output directory. For the latter, you must provide a valid file path with the 'Optional Output Filepath' parameter.
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' module.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputShape (*)Shapes (optional input)AOI_SHPShapefile describing the AOI.-
Grid (*)Grid (optional input)AOI_GRIDGrid describing the AOI.-
OutputPoint Cloud (*)Point Cloud list (optional output)PC_OUTThe output point cloud(s)-
OptionsFilenameFile pathFILENAMEThe full path and name of the .spcvf file-
Optional Output FilepathFile pathFILEPATHThe full path to which the output(s) should be written. Leave empty to output the datasets as point cloud list.-
Tilename (*)Table fieldFIELD_TILENAMEAttribute used for naming the output file(s)-
X-ExtentValue rangeAOI_XRANGEMinimum and maximum x-coordinate of AOI.-
Y-ExtentValue rangeAOI_YRANGEMinimum and maximum y-coordinate of AOI.-
Add OverlapBooleanAOI_ADD_OVERLAPAdd overlap to AOIDefault: 0
OverlapFloating pointOVERLAPOverlap [map units]Minimum: 0.000000
Default: 50.000000
One Point Cloud per PolygonBooleanONE_PC_PER_POLYGONWrite one point cloud dataset for each polygonDefault: 0
(*) optional

Command-line

Usage: saga_cmd io_virtual 1 [-FILENAME <str>] [-PC_OUT <str>] [-FILEPATH <str>] [-AOI_SHP <str>] [-FIELD_TILENAME <str>] [-AOI_GRID <str>] [-AOI_XRANGE_MIN <str>] [-AOI_XRANGE_MAX <str>] [-AOI_YRANGE_MIN <str>] [-AOI_YRANGE_MAX <str>] [-AOI_ADD_OVERLAP <str>] [-OVERLAP <str>] [-ONE_PC_PER_POLYGON <str>]
  -FILENAME:<str>          	Filename
	File path
  -PC_OUT:<str>            	Point Cloud
	Point Cloud list (optional output)
  -FILEPATH:<str>          	Optional Output Filepath
	File path
  -AOI_SHP:<str>           	Shape
	Shapes (optional input)
  -FIELD_TILENAME:<str>    	Tilename
	Table field
  -AOI_GRID:<str>          	Grid
	Grid (optional input)
  -AOI_XRANGE_MIN:<str>    	X-Extent
	Value range
  -AOI_XRANGE_MAX:<str>    	X-Extent
	Value range
  -AOI_YRANGE_MIN:<str>    	Y-Extent
	Value range
  -AOI_YRANGE_MAX:<str>    	Y-Extent
	Value range
  -AOI_ADD_OVERLAP:<str>   	Add Overlap
	Boolean
	Default: 0
  -OVERLAP:<str>           	Overlap
	Floating point
	Minimum: 0.000000
	Default: 50.000000
  -ONE_PC_PER_POLYGON:<str>	One Point Cloud per Polygon
	Boolean
	Default: 0