
NAME
r.series - Makes each output cell value a function of the values assigned to the corresponding cells in the input raster map layers.
KEYWORDS
raster, series
SYNOPSIS
r.series
r.series help
r.series [-qn] input=name[,name,...] output=name[,name,...] method=string[,string,...] [range=lo,hi] [--overwrite] [--verbose] [--quiet]
Flags:
- -q
- Run quietly
- -n
- Propagate NULLs
- --overwrite
- Allow output files to overwrite existing files
- --verbose
- Verbose module output
- --quiet
- Quiet module output
Parameters:
- input=name[,name,...]
- Name of input raster map(s)
- output=name[,name,...]
- Name for output raster map
- method=string[,string,...]
- Aggregate operation
- Options: average,count,median,mode,minimum,min_raster,maximum,max_raster,stddev,range,sum,variance,diversity,slope,offset,detcoeff,quart1,quart3,perc90,skewness,kurtosis
- range=lo,hi
- Ignore values outside this range
DESCRIPTION
r.series makes each output cell value a function of the values
assigned to the corresponding cells in the input raster map layers.
Following methods are available:
- average: average value
- count: count of non-NULL cells
- median: median value
- mode: most frequently occuring value
- minimum: lowest value
- maximum: highest value
- range: range of values (max - min)
- stddev: standard deviation
- sum: sum of values
- variance: statistical variance
- diversity: number of different values
- slope: linear regression slope
- offset: linear regression offset
- detcoeff: linear regression coefficient of determination
- min_raster: raster map number with the minimum time-series value
- max_raster: raster map number with the maximum time-series value
NOTES
With -n flag, any cell for which any of the corresponding input cells are
NULL is automatically set to NULL (NULL propagation). The aggregate function is not
called, so all methods behave this way with respect to the -n flag.
Without -n flag, the complete list of inputs for each cell (including
NULLs) is passed to the aggregate function. Individual aggregates can
handle data as they choose. Mostly, they just compute the aggregate
over the non-NULL values, producing a NULL result only if all inputs
are NULL.
The min_raster and max_raster methods generate a map with the
number of the raster map that holds the minimum/maximum value of the
time-series. The numbering starts at 0 up to n for the
first and the last raster listed in input=, respectively.
If the range= option is given, any values which fall outside
that range will be treated as if they were NULL.
The range parameter can be set to low,high thresholds:
values outside of this range are treated as NULL (i.e., they will be
ignored by most aggregates, or will cause the result to be NULL if -n is given).
The low,high thresholds are floating point, so use -inf or
inf for a single threshold (e.g., range=0,inf to ignore
negative values, or range=-inf,-200.4 to ignore values above -200.4).
EXAMPLES
Using r.series with wildcards:
r.series input="`g.mlist pattern='insitu_data.*' sep=,`"
output=insitu_data.stddev method=stddev
Note the g.mlist script also supports regular expressions for
selecting map names.
Example for multiple aggregates to be computed in one run (3 resulting aggregates from two input maps):
r.series in=one,two out=result_avg,res_slope,result_count meth=sum,slope,count
SEE ALSO
g.mlist,
g.region
AUTHOR
Glynn Clements
Last changed: $Date: 2008-10-16 13:12:10 +0200 (Thu, 16 Oct 2008) $
Main index - raster index - Full index
© 2003-2009 GRASS Development Team