Tool Import Grid from XYZ
The tool allows one to import gridded data from a table (text format), which contains for each grid cell the x/y-coordinates and the cell value. If several values end up in a single grid cell, the mean value of all input values is written to that cell.
- Author: O.Conrad (c) 2009
- Menu: File|Grid|Import
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Output | Grid (*) | data object Grid, output, optional | GRID | The imported grid. | - |
| Count Grid (*) | data object Grid, output, optional | COUNT | The number of values detected in each grid cell. | - |
| Options | File | file path | FILENAME | The input file. | - |
| Skip Leading Lines | integer number | SKIP | The number of leading lines to skip (usually header data). | Minimum: 0
Default: 0 |
| Separator | choice | SEPARATOR | - | Available Choices:
[0] default delimiters
[1] space
[2] ,
[3] ;
[4] tabulator
[5] user defined
Default: 0 |
| User Defined | text | USER | The user defined delimiter. | Default: * |
| Data Storage Type | data type | TYPE | - | Available Choices:
[0] bit
[1] unsigned 1 byte integer
[2] signed 1 byte integer
[3] unsigned 2 byte integer
[4] signed 2 byte integer
[5] unsigned 4 byte integer
[6] signed 4 byte integer
[7] unsigned 8 byte integer
[8] signed 8 byte integer
[9] 4 byte floating point number
[10] 8 byte floating point number
Default: 9 |
| Cell Size | floating point number | CELLSIZE | The cell size of the output grid. Set to zero to let the tool suggest an appropriate cellsize. | Minimum: 0.000000
Default: 1.000000 |
| Count Grid | boolean | COUNT_CREATE | Create a grid with the number of values falling into each target grid cell. | Default: 0 |
| (*) optional |
Command-line
Usage: saga_cmd io_grid 6 [-GRID <str>] [-COUNT <str>] [-FILENAME <str>] [-SKIP <num>] [-SEPARATOR <str>] [-USER <str>] [-TYPE <str>] [-CELLSIZE <double>] [-COUNT_CREATE <str>]
-GRID:<str> Grid
data object Grid, output, optional
-COUNT:<str> Count Grid
data object Grid, output, optional
-FILENAME:<str> File
file path
-SKIP:<num> Skip Leading Lines
integer number
Minimum: 0
Default: 0
-SEPARATOR:<str> Separator
choice
Available Choices:
[0] default delimiters
[1] space
[2] ,
[3] ;
[4] tabulator
[5] user defined
Default: 0
-USER:<str> User Defined
text
Default: *
-TYPE:<str> Data Storage Type
data type
Available Choices:
[0] bit
[1] unsigned 1 byte integer
[2] signed 1 byte integer
[3] unsigned 2 byte integer
[4] signed 2 byte integer
[5] unsigned 4 byte integer
[6] signed 4 byte integer
[7] unsigned 8 byte integer
[8] signed 8 byte integer
[9] 4 byte floating point number
[10] 8 byte floating point number
Default: 9
-CELLSIZE:<double> Cell Size
floating point number
Minimum: 0.000000
Default: 1.000000
-COUNT_CREATE:<str> Count Grid
boolean
Default: 0