Tool Focal Statistics
Based on its neighbourhood this tool calculates for each grid cell various statistical measures. According to Wilson & Gallant (2000) this tool was named 'Residual Analysis (Grid)' in earlier versions.
References
- Wilson, J.P. & Gallant, J.C. [Eds.] (2000): Terrain analysis - principles and applications. New York, John Wiley & Sons, Inc.
- Author: O.Conrad (c) 2003
- Menu: Spatial and Geostatistics|Grids
Parameters
| Name | Type | Identifier | Description | Constraints |
Input | Grid | Grid, input | GRID | - | - |
Output | Mean Value (*) | Grid, output, optional | MEAN | - | - |
Minimum Value (*) | Grid, output, optional | MIN | - | - |
Maximum Value (*) | Grid, output, optional | MAX | - | - |
Value Range (*) | Grid, output, optional | RANGE | - | - |
Standard Deviation (*) | Grid, output, optional | STDDEV | - | - |
Variance (*) | Grid, output, optional | VARIANCE | - | - |
Sum (*) | Grid, output, optional | SUM | - | - |
Difference from Mean Value (*) | Grid, output, optional | DIFF | - | - |
Deviation from Mean Value (*) | Grid, output, optional | DEVMEAN | - | - |
Percentile (*) | Grid, output, optional | PERCENT | - | - |
Median (*) | Grid, output, optional | MEDIAN | - | - |
Minority (*) | Grid, output, optional | MINORITY | - | - |
Majority (*) | Grid, output, optional | MAJORITY | - | - |
Options | Grid System | Grid system | PARAMETERS_GRID_SYSTEM | - | - |
Include Center Cell | Boolean | BCENTER | - | Default: 1 |
Kernel Type | Choice | KERNEL_TYPE | The kernel's shape. | Available Choices: [0] Square [1] Circle [2] Annulus [3] Sector Default: 1 |
Inner Radius | Integer | KERNEL_INNER | cells | Minimum: 0 Default: 0 |
Radius | Integer | KERNEL_RADIUS | cells | Minimum: 0 Default: 2 |
Direction | Floating point | KERNEL_DIRECTION | degree | Minimum: -360.000000 Maximum: 360.000000 Default: 0.000000 |
Tolerance | Floating point | KERNEL_TOLERANCE | degree | Minimum: 0.000000 Maximum: 180.000000 Default: 5.000000 |
Weighting Function | Choice | DW_WEIGHTING | - | Available Choices: [0] no distance weighting [1] inverse distance to a power [2] exponential [3] gaussian Default: 0 |
Power | Floating point | DW_IDW_POWER | - | Minimum: 0.000000 Default: 2.000000 |
Bandwidth | Floating point | DW_BANDWIDTH | Bandwidth for exponential and Gaussian weighting | Minimum: 0.000000 Default: 1.000000 |
(*) optional |
Command-line
Usage: saga_cmd statistics_grid 1 [-GRID <str>] [-MEAN <str>] [-MIN <str>] [-MAX <str>] [-RANGE <str>] [-STDDEV <str>] [-VARIANCE <str>] [-SUM <str>] [-DIFF <str>] [-DEVMEAN <str>] [-PERCENT <str>] [-MEDIAN <str>] [-MINORITY <str>] [-MAJORITY <str>] [-BCENTER <str>] [-KERNEL_TYPE <str>] [-KERNEL_INNER <num>] [-KERNEL_RADIUS <num>] [-KERNEL_DIRECTION <double>] [-KERNEL_TOLERANCE <double>] [-DW_WEIGHTING <str>] [-DW_IDW_POWER <double>] [-DW_BANDWIDTH <double>]
-GRID:<str> Grid
Grid, input
-MEAN:<str> Mean Value
Grid, output, optional
-MIN:<str> Minimum Value
Grid, output, optional
-MAX:<str> Maximum Value
Grid, output, optional
-RANGE:<str> Value Range
Grid, output, optional
-STDDEV:<str> Standard Deviation
Grid, output, optional
-VARIANCE:<str> Variance
Grid, output, optional
-SUM:<str> Sum
Grid, output, optional
-DIFF:<str> Difference from Mean Value
Grid, output, optional
-DEVMEAN:<str> Deviation from Mean Value
Grid, output, optional
-PERCENT:<str> Percentile
Grid, output, optional
-MEDIAN:<str> Median
Grid, output, optional
-MINORITY:<str> Minority
Grid, output, optional
-MAJORITY:<str> Majority
Grid, output, optional
-BCENTER:<str> Include Center Cell
Boolean
Default: 1
-KERNEL_TYPE:<str> Kernel Type
Choice
Available Choices:
[0] Square
[1] Circle
[2] Annulus
[3] Sector
Default: 1
-KERNEL_INNER:<num> Inner Radius
Integer
Minimum: 0
Default: 0
-KERNEL_RADIUS:<num> Radius
Integer
Minimum: 0
Default: 2
-KERNEL_DIRECTION:<double> Direction
Floating point
Minimum: -360.000000
Maximum: 360.000000
Default: 0.000000
-KERNEL_TOLERANCE:<double> Tolerance
Floating point
Minimum: 0.000000
Maximum: 180.000000
Default: 5.000000
-DW_WEIGHTING:<str> Weighting Function
Choice
Available Choices:
[0] no distance weighting
[1] inverse distance to a power
[2] exponential
[3] gaussian
Default: 0
-DW_IDW_POWER:<double> Power
Floating point
Minimum: 0.000000
Default: 2.000000
-DW_BANDWIDTH:<double> Bandwidth
Floating point
Minimum: 0.000000
Default: 1.000000