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.
- Author: V. Wichmann, LASERDATA GmbH (c) 2014
- Specification: grid
- Menu: File|Virtual|Point Cloud
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Input | Shape (*) | Shapes (optional input) | AOI_SHP | Shapefile describing the AOI. | - |
| Grid (*) | Grid (optional input) | AOI_GRID | Grid describing the AOI. | - |
| Output | Point Cloud (*) | Point Cloud list (optional output) | PC_OUT | The output point cloud(s) | - |
| Options | Filename | File path | FILENAME | The full path and name of the .spcvf file | - |
| Optional Output Filepath | File path | FILEPATH | The full path to which the output(s) should be written. Leave empty to output the datasets as point cloud list. | - |
| Tilename (*) | Table field | FIELD_TILENAME | Attribute used for naming the output file(s) | - |
| X-Extent | Value range | AOI_XRANGE | Minimum and maximum x-coordinate of AOI. | - |
| Y-Extent | Value range | AOI_YRANGE | Minimum and maximum y-coordinate of AOI. | - |
| Add Overlap | Boolean | AOI_ADD_OVERLAP | Add overlap to AOI | Default: 0 |
| Overlap | Floating point | OVERLAP | Overlap [map units] | Minimum: 0.000000
Default: 50.000000 |
| One Point Cloud per Polygon | Boolean | ONE_PC_PER_POLYGON | Write one point cloud dataset for each polygon | Default: 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