| 1 |
<h2>DESCRIPTION</h2> |
| 2 |
|
| 3 |
<b>t.rast.accdetect</b> is designed to detect accumulation pattern in |
| 4 |
temporally accumulated space time raster datasets created by |
| 5 |
<a href="t.rast.accumulate.html">t.rast.accumulate</a>. |
| 6 |
|
| 7 |
This module's input is a space time raster dataset resulting from |
| 8 |
a <a href="t.rast.accumulate.html">t.rast.accumulate</a> run. |
| 9 |
<p> |
| 10 |
The <b>start</b> time and the <b>end</b> time of the pattern detection |
| 11 |
process must be set, eg. <b>start="2000-03-01" end="2011-01-01"</b>. |
| 12 |
The <b>start</b> and <b>end</b> time do not need to be the same as for |
| 13 |
the accumulation run that produced the input space time raster dataset. |
| 14 |
In addition a <b>cycle</b>, eg. "8 months", can be specified, that |
| 15 |
defines after which time interval the accumulation pattern detection |
| 16 |
process restarts. The <b>offset</b> option specifies the time that |
| 17 |
should be skipped between two cycles, eg. "4 months". The <b>cycle</b> |
| 18 |
and <b>offset</b> options must be exactly the same that were used in the |
| 19 |
accumulation process that generated the input space time raster dataset, |
| 20 |
otherwise the accumulation pattern detection will produce wrong |
| 21 |
results. |
| 22 |
<p> |
| 23 |
The <b>minimum</b> and <b>maximum</b> values for the pattern detection |
| 24 |
process can be set either by using space time raster datasets or |
| 25 |
by using fixed values for all raster cells and time steps. |
| 26 |
<p> |
| 27 |
Using space time raster datasets allows specifying minimum and maximum |
| 28 |
values for each raster cell and each time step. For example, we want to |
| 29 |
detect the germination (minimum value) and harvesting (maximum value) |
| 30 |
dates for different crops in Germany using the growing-degree-day (GDD) |
| 31 |
method for several years. Different crops may grow in different raster |
| 32 |
cells and change with time because of crop rotation. Hence we need to |
| 33 |
specify different GDD germination/harvesting (minimum/maximum) values |
| 34 |
for different raster cells and different years. |
| 35 |
<p> |
| 36 |
The raster maps that specify the minimum and maximum values of the |
| 37 |
actual granule will be detected using the following temporal relations: |
| 38 |
equals, during, overlaps, overlapped and contains. First, all maps with |
| 39 |
time stamps <i>equal</i> to the current granule of the input STRDS will be |
| 40 |
detected, the first minimum map and the first maximum map that are |
| 41 |
found will be used as range definitions. If no equal maps are found, then |
| 42 |
maps with a temporal <i>during</i> relation will be detected, then maps |
| 43 |
that temporally <i>overlap</i> the actual granules and finally, maps that |
| 44 |
have a temporal <i>contain</i> relation will be detected. If no maps are |
| 45 |
found or minimum/maximum STRDS are not set, then the <b>range</b> option |
| 46 |
is used, eg. <b>range=480,730</b>. |
| 47 |
<p> |
| 48 |
The <b>base</b> name of of the generated maps must always be set. |
| 49 |
<p> |
| 50 |
This module produces two output space time raster datasets: occurrence |
| 51 |
and indicator. The <b>occurrence</b> output STRDS stores the time in |
| 52 |
days from the beginning of a given cycle for each raster cell and time |
| 53 |
step that has a value within the minimum and maximum definition. These |
| 54 |
values can be used to compute the duration of the recognized accumulation |
| 55 |
pattern. |
| 56 |
The <b>indicator</b> output STRDS uses three integer values to mark |
| 57 |
raster cells as beginning, intermediate state or end of an accumulation |
| 58 |
pattern. By default, the module uses 1 to indicate the start, 2 for |
| 59 |
the intermediate state and 3 to mark the end of the accumulation pattern |
| 60 |
in a cycle. These default values can be changed using the <b>staend</b> |
| 61 |
option. |
| 62 |
|
| 63 |
<h2>EXAMPLE</h2> |
| 64 |
|
| 65 |
Please have a look at the <a href="t.rast.accumulate.html">t.rast.accumulate</a> example. |
| 66 |
|
| 67 |
<h2>SEE ALSO</h2> |
| 68 |
|
| 69 |
<em> |
| 70 |
<a href="t.rast.accumulate.html">t.rast.accumulate</a>, |
| 71 |
<a href="t.rast.aggregate.html">t.rast.aggregate</a>, |
| 72 |
<a href="t.rast.mapcalc.html">t.rast.mapcalc</a>, |
| 73 |
<a href="t.info.html">t.info</a>, |
| 74 |
<a href="r.series.accumulate.html">r.series.accumulate</a>, |
| 75 |
<a href="g.region.html">g.region</a> |
| 76 |
</em> |
| 77 |
|
| 78 |
<h2>AUTHOR</h2> |
| 79 |
|
| 80 |
Sören Gebbert, Thünen Institute of Climate-Smart Agriculture |