Tool Create Grid System
This tool creates a new user specified Grid System for use with other tools.
First of all, please consider the following issues before using the tool:
(a) all calculations of the tool refer to the lower left corner of the grid system, i.e. the xMin and yMin values. This coordinate is fixed unless you specify an offset.
(b) the tool follows the philosophy of SAGA in that the values describing the extent refer to the cell centers. If you like to match the extent with the border of a grid, use an offset.
The tool provides four possibilities to set/determine the extent of the grid system:
(1) by specifying the coordinate of the lower left cell (xMin, yMin) and the number of cells in W-E (NX) and S-N (NY) direction
(2) by specifying the coordinates the of lower left (xMin, yMin) and the upper right (xMax, yMax) cell
(3) by the extent of the shape(s) provided in the Data Objects section
(4) by the extent of the grid(s) provided in the Data Objects section
After selecting the appropriate method to determine the extent, the next step is to specify the Cellsize of the new grid system.
For all methods supplied to determine the extent but number (1), three possibilities are provided to adjust Cellsize and grid system extent (please remember, the lower left corner is fixed!):
(I) adjust the extent to match the Cellsize
(II) adjust the Cellsize to match the extent in E-W direction
(III) adjust the Cellsize to match the extent in S-N direction
Finally it is possible to apply an offset to the lower left corner of the grid system. In this case check the Use Offset option and specify the offset in W-E and S-N direction. Positive values result in a shift in E/N, negative in W/S direction.
In order to create the grid system the tool needs to create a dummy grid.
- Author: Volker Wichmann (c) 2007
- Menu: Grid|Grid System
Parameters
| Name | Type | Identifier | Description | Constraints |
Input | Shapes Layers | Shapes list, input | SHAPESLIST | - | - |
Grids | Grid list, input | GRIDLIST | - | - |
Output | Dummy Grid (*) | Data Object Grid, output, optional | GRID | - | - |
Options | Initialization Value | Floating point | INIT | Value which is assigned to the dummy grid. | Default: 0.000000 |
Cellsize | Floating point | CELLSIZE | - | Minimum: 0.000000 Default: 10.000000 |
Extent Definition | Choice | M_EXTENT | - | Available Choices: [0] lower left coordinate and number of rows and columns [1] lower left and upper right coordinates [2] one or more shapes layers [3] one or more grids Default: 0 |
Adjust | Choice | ADJUST | - | Available Choices: [0] extent to cell size [1] cell size to left-right extent [2] cell size to bottom-top extent Default: 0 |
Left | Floating point | XMIN | - | Default: 0.000000 |
Right | Floating point | XMAX | - | Default: 100.000000 |
Columns | Integer | NX | - | Minimum: 1 Default: 10 |
Bottom | Floating point | YMIN | - | Default: 0.000000 |
Top | Floating point | YMAX | - | Default: 100.000000 |
Rows | Integer | NY | - | Minimum: 1 Default: 10 |
Use Offset | Boolean | USEOFF | - | Default: 0 |
X Offset | Floating point | XOFFSET | Positive values result in a shift in E direction. | Default: 0.000000 |
Y Offset | Floating point | YOFFSET | Positive values result in a shift in N direction. | Default: 0.000000 |
(*) optional |
Command-line
Usage: saga_cmd grid_tools 23 [-GRID <str>] [-INIT <double>] [-CELLSIZE <double>] [-M_EXTENT <str>] [-ADJUST <str>] [-XMIN <double>] [-XMAX <double>] [-NX <num>] [-YMIN <double>] [-YMAX <double>] [-NY <num>] [-SHAPESLIST <str>] [-GRIDLIST <str>] [-USEOFF <str>] [-XOFFSET <double>] [-YOFFSET <double>]
-GRID:<str> Dummy Grid
Data Object Grid, output, optional
-INIT:<double> Initialization Value
Floating point
Default: 0.000000
-CELLSIZE:<double> Cellsize
Floating point
Minimum: 0.000000
Default: 10.000000
-M_EXTENT:<str> Extent Definition
Choice
Available Choices:
[0] lower left coordinate and number of rows and columns
[1] lower left and upper right coordinates
[2] one or more shapes layers
[3] one or more grids
Default: 0
-ADJUST:<str> Adjust
Choice
Available Choices:
[0] extent to cell size
[1] cell size to left-right extent
[2] cell size to bottom-top extent
Default: 0
-XMIN:<double> Left
Floating point
Default: 0.000000
-XMAX:<double> Right
Floating point
Default: 100.000000
-NX:<num> Columns
Integer
Minimum: 1
Default: 10
-YMIN:<double> Bottom
Floating point
Default: 0.000000
-YMAX:<double> Top
Floating point
Default: 100.000000
-NY:<num> Rows
Integer
Minimum: 1
Default: 10
-SHAPESLIST:<str> Shapes Layers
Shapes list, input
-GRIDLIST:<str> Grids
Grid list, input
-USEOFF:<str> Use Offset
Boolean
Default: 0
-XOFFSET:<double> X Offset
Floating point
Default: 0.000000
-YOFFSET:<double> Y Offset
Floating point
Default: 0.000000