<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: r.series</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>r.series</b></em> - Makes each output cell value a function of the values assigned to the corresponding cells in the input raster map layers.
<h2>KEYWORDS</h2>
raster, series
<h2>SYNOPSIS</h2>
<b>r.series</b><br>
<b>r.series help</b><br>
<b>r.series</b> [-<b>qn</b>] <b>input</b>=<em>name</em>[,<i>name</i>,...] <b>output</b>=<em>name</em> <b>method</b>=<em>string</em> [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-q</b></DT>
<DD>Run quietly</DD>
<DT><b>-n</b></DT>
<DD>Propagate NULLs</DD>
<DT><b>--overwrite</b></DT>
<DD>Allow output files to overwrite existing files</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>input</b>=<em>name[,<i>name</i>,...]</em></DT>
<DD>Name of input raster map(s)</DD>
<DT><b>output</b>=<em>name</em></DT>
<DD>Name for output raster map</DD>
<DT><b>method</b>=<em>string</em></DT>
<DD>Aggregate operation</DD>
<DD>Options: <em>average,count,median,mode,minimum,min_raster,maximum,max_raster,stddev,range,sum,variance,diversity,slope,offset,detcoeff,quart1,quart3,perc90</em></DD>
</DL>
<H2>DESCRIPTION</H2>
<EM>r.series</EM> 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:
<ul>
<li>average: average value
<li>count: count of non-NULL cells
<li>median: median value
<li>mode: most frequently occuring value
<li>minimum: lowest value
<li>maximum: highest value
<li>range: range of values (max - min)
<li>stddev: standard deviation
<li>sum: sum of values
<li>variance: statistical variance
<li>diversity: number of different values
<li>slope: linear regression slope
<li>offset: linear regression offset
<li>detcoeff: linear regression coefficient of determination
<li>min_raster: raster map number with the minimum time-series value
<li>max_raster: raster map number with the maximum time-series value
</ul>
<H2>NOTES</H2>
With <EM>-n</EM> 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 <EM>-n</EM> flag.
<P>
Without <EM>-n</EM> 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.
<p>
The <EM>min_raster</EM> and <EM>max_raster</EM> 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 <EM>0</EM> up to <EM>n</EM> for the
first and the last raster listed in <EM>input=</EM>, respectively.
<H2>EXAMPLE</H2>
Using <EM>r.series</EM> with wildcards:
<br>
<tt>r.series input="`g.mlist pattern='insitu_data.*' sep=,`"
output=insitu_data.stddev method=stddev</tt>
<P>
Note the <EM>g.mlist</EM> script also supports regular expressions for
selecting map names.
<H2>SEE ALSO</H2>
<EM><A HREF="g.mlist.html">g.mlist</A></EM>,
<EM><A HREF="g.region.html">g.region</A></EM>
<H2>AUTHOR</H2>
Glynn Clements
<p><i>Last changed: $Date: 2007-10-23 14:11:17 +0200 (Tue, 23 Oct 2007) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
