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 | 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 | Choice | TYPE | - | Available Choices: [0] 1 bit [1] 1 byte unsigned integer [2] 1 byte signed integer [3] 2 byte unsigned integer [4] 2 byte signed integer [5] 4 byte unsigned integer [6] 4 byte signed integer [7] 4 byte floating point [8] 8 byte floating point Default: 7 |
Cell Size | Floating point | 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
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
Choice
Available Choices:
[0] 1 bit
[1] 1 byte unsigned integer
[2] 1 byte signed integer
[3] 2 byte unsigned integer
[4] 2 byte signed integer
[5] 4 byte unsigned integer
[6] 4 byte signed integer
[7] 4 byte floating point
[8] 8 byte floating point
Default: 7
-CELLSIZE:<double> Cell Size
Floating point
Minimum: 0.000000
Default: 1.000000
-COUNT_CREATE:<str> Count Grid
Boolean
Default: 0