GRASS logo
Manual for r.finder (GRASS-GIS script) This is not an official GRASS-GIS manual page

NAME

r.finder - outs a map containing all cells matching the same combination of thematic maps parameters of the cells in the input map.

KEYWORDS

raster,statistics,ranges

SYNOPSIS

r.finder
r.finder help
r.finder [-skdort] [input=raster] [qual=raster] [quant=raster] [rules=file] [output=name] [comment=string] [--verbose] [--quiet]

Flags:

-s
Save also statistical reports and graphs
-k
Keep current region settings (otherwise, region is set on input raster map by default)
-d
Use standard deviation instead of range for quantitative map(s)
-o
Allow overwrite
-r
Save Rules file (.rul)
-t
Save a Template for rules file and exit
--verbose
Verbose module output
--quiet
Quiet module output

Parameters:

input=name
Name of input raster map
qual=name
Name of qualitative raster map(s)
quant=name
Name of quantitative raster map(s)
output=name
Name of output raster map
rules=name
Path to rules file
comment=string
Comment to be added to rules file

DESCRIPTION

r.finder outs a map containing all cells matching the same combination of thematic maps parameters of the non-null/non-zero cells in the input map. May out as well a statistical report and graphs (through r.report, d.histogram) of the cell values. The purpose is to check for the features of the cells where input map items are located, and to produce a map representing the increasing probability of analogy with the occurrence areas represented by the non-null and non-zero input cells (i.e. the number of parameters matching the presence areas). The program distinguishes quantitative thematic maps (single values in presence are considered) and quantitative maps (the whole data range between min and max - or the standard deviation if flag -d is active - is considered). For instance, r.finder will search, for any 'qual' map used, the values of the cells corresponding to the presence cells in the input map and consider as valid all cells matching such values. The same is done for 'quant' maps, but considering the whole range between min and max values present in the input map (or the standard deviation if flag -s is present). Then, r.finder, will patch all the resulting maps, and create a new raster map representing the overlapping valid areas of different maps and showing the increasing similarity of cells to the ones covered by presence items in the input map. Additionally, r.finder may create statistic statistical report and graphs (through r.report, d.histogram) of the cells' values distribution and rules files containing the parameters used, in order to perform the same operation on different areas.




Example of a rules file:



[title]
--------------------------------------------------------------------------
[text (You can add, edit or remove whichever comment here)]

---------------------------------------------------------------------------

MAP RULES BOX: THIS IS THE PART OF THE TEXT FILE READ AT RUNTIME:

#(qual)mapnameA,categories:0;0;0#
#(quant)mapnameB,ranges:0-0#
#(qual)mapnameC,categories:0;0;0;0;0;0#
#(quant)mapnameE,ranges:0-0;0-0;0-0#

-----------------------------------------------------------------------------


NOTES

Due to the math library used, r.finder in "quant" mode works properly only with double decimal numbers. In case of cell values with more than two decimals, only the first two are evaluated in order to set the range. Otherwise, for "qual" maps, values are considered as strings, then whichever number can be used.

AUTHORS

Augusto Palombini

Last changed: April 21st, 2012