Tool Get Grid from Virtual Point Cloud
The tool allows one to retrieve a grid 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 a grid 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 grid list or written to an output directory. For the latter, you must provide a valid file path with the 'Optional Output Filepath' parameter.
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.
- Author: V. Wichmann, LASERDATA GmbH (c) 2014
- Menu: File|Virtual|Point Cloud
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Input | Shape (*) | Shapes, input, optional | AOI_SHP | Shapefile describing the AOI. | - |
| Grid (*) | Grid, input, optional | AOI_GRID | Grid describing the AOI. | - |
| Output | Grid (*) | Grid list, output, optional | GRID_OUT | The output grid(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 grid list. | - |
| Attribute Field to Grid | Integer | ATTR_FIELD_GRID | The attribute field to grid. Field numbers start with 1, so elevation is attribute field 3. | Minimum: 3
Default: 1 |
| Cellsize | Floating point | CELL_SIZE | Cellsize of the output grid [map units] | Minimum: 0.001000
Default: 1.000000 |
| Grid System Fit | Choice | GRID_SYSTEM_FIT | Choose how to align the ouput grid system to the AOI | Available Choices:
[0] nodes
[1] cells
Default: 1 |
| Aggregation | Choice | METHOD | Choose how to aggregate the values | Available Choices:
[0] lowest
[1] highest
Default: 1 |
| Constrain Query | Boolean | CONSTRAIN_QUERY | Check this parameter to constrain the query by an attribute range. | Default: 0 |
| Attribute Field | Integer | ATTR_FIELD | The attribute field to use as constraint. Field numbers start with 1. | Minimum: 1
Default: 1 |
| Value Range | Value range | VALUE_RANGE | Minimum and maximum of attribute range []. | - |
| Tilename (*) | Table field | FIELD_TILENAME | Attribute used for naming the output file(s) | - |
| Grid system | Grid system | AOI_GRID_GRIDSYSTEM | - | - |
| 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 |
| (*) optional |
Command-line
Usage: saga_cmd io_virtual 4 [-FILENAME <str>] [-GRID_OUT <str>] [-FILEPATH <str>] [-ATTR_FIELD_GRID <num>] [-CELL_SIZE <double>] [-GRID_SYSTEM_FIT <str>] [-METHOD <str>] [-CONSTRAIN_QUERY <str>] [-ATTR_FIELD <num>] [-VALUE_RANGE_MIN <double>] [-VALUE_RANGE_MAX <double>] [-AOI_SHP <str>] [-FIELD_TILENAME <str>] [-AOI_GRID <str>] [-AOI_XRANGE_MIN <double>] [-AOI_XRANGE_MAX <double>] [-AOI_YRANGE_MIN <double>] [-AOI_YRANGE_MAX <double>] [-AOI_ADD_OVERLAP <str>] [-OVERLAP <double>]
-FILENAME:<str> Filename
File path
-GRID_OUT:<str> Grid
Grid list, output, optional
-FILEPATH:<str> Optional Output Filepath
File path
-ATTR_FIELD_GRID:<num> Attribute Field to Grid
Integer
Minimum: 3
Default: 1
-CELL_SIZE:<double> Cellsize
Floating point
Minimum: 0.001000
Default: 1.000000
-GRID_SYSTEM_FIT:<str> Grid System Fit
Choice
Available Choices:
[0] nodes
[1] cells
Default: 1
-METHOD:<str> Aggregation
Choice
Available Choices:
[0] lowest
[1] highest
Default: 1
-CONSTRAIN_QUERY:<str> Constrain Query
Boolean
Default: 0
-ATTR_FIELD:<num> Attribute Field
Integer
Minimum: 1
Default: 1
-VALUE_RANGE_MIN:<double> Value Range
Value range
-VALUE_RANGE_MAX:<double> Value Range
Value range
-AOI_SHP:<str> Shape
Shapes, input, optional
-FIELD_TILENAME:<str> Tilename
Table field
-AOI_GRID:<str> Grid
Grid, input, optional
-AOI_XRANGE_MIN:<double> X-Extent
Value range
-AOI_XRANGE_MAX:<double> X-Extent
Value range
-AOI_YRANGE_MIN:<double> Y-Extent
Value range
-AOI_YRANGE_MAX:<double> Y-Extent
Value range
-AOI_ADD_OVERLAP:<str> Add Overlap
Boolean
Default: 0
-OVERLAP:<double> Overlap
Floating point
Minimum: 0.000000
Default: 50.000000