Debian Codegraph @

temporal/t.rast.accdetect/t.rast.accdetect.html

raw
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&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture