t.rast.series(1grass)

1t.rast.series(1)              Grass User's Manual             t.rast.series(1)
2
3
4

NAME

6       t.rast.series    -   Performs  different  aggregation  algorithms  from
7       r.series on all or a subset of raster  maps  in  a  space  time  raster
8       dataset.
9

KEYWORDS

11       temporal, aggregation, series, raster, time
12

SYNOPSIS

14       t.rast.series
15       t.rast.series --help
16       t.rast.series    [-tn]   input=name   method=string    [quantile=float]
17       [order=string[,string,...]]   [where=sql_query]  output=name   [--over‐
18       write]  [--help]  [--verbose]  [--quiet]  [--ui]
19
20   Flags:
21       -t
22           Do  not  assign the space time raster dataset start and end time to
23           the output map
24
25       -n
26           Propagate NULLs
27
28       --overwrite
29           Allow output files to overwrite existing files
30
31       --help
32           Print usage summary
33
34       --verbose
35           Verbose module output
36
37       --quiet
38           Quiet module output
39
40       --ui
41           Force launching GUI dialog
42
43   Parameters:
44       input=name [required]
45           Name of the input space time raster dataset
46
47       method=string [required]
48           Aggregate operation to be performed on the raster maps
49           Options: average, count, median, mode, minimum,  min_raster,  maxi‐
50           mum,  max_raster,  stddev,  range, sum, variance, diversity, slope,
51           offset, detcoeff, quart1, quart3, perc90, quantile, skewness,  kur‐
52           tosis
53           Default: average
54
55       quantile=float
56           Quantile to calculate for method=quantile
57           Options: 0.0-1.0
58
59       order=string[,string,...]
60           Sort the maps by category
61           Options:  id,   name,  creator,  mapset,  creation_time,  modifica‐
62           tion_time,  start_time,  end_time,  north,   south,   west,   east,
63           min,  max
64           Default: start_time
65
66       where=sql_query
67           WHERE  conditions  of SQL statement without ’where’ keyword used in
68           the temporal GIS framework
69           Example: start_time > ’2001-01-01 12:30:00’
70
71       output=name [required]
72           Name for output raster map
73

DESCRIPTION

75       t.rast.series is a simple wrapper for the raster  module  r.series.  It
76       supports a subset of the aggregation methods of r.series.
77
78       The  input  of  this  module is a single space time raster dataset, the
79       output is a single raster map layer. A subset of the input  space  time
80       raster  dataset  can be selected using the where option. The sorting of
81       the raster map layer can be set using the order option. Be  aware  that
82       the  order  of  the  maps can significantly influence the result of the
83       aggregation  (e.g.:  slope).  By  default  the  maps  are  ordered   by
84       start_time.
85

EXAMPLE

87       Estimate average temperature for the whole time series
88       t.rast.series input=tempmean_monthly output=tempmean_general method=average
89       Estimate  average  temperature for all January maps in the time series,
90       the so-called climatology
91       t.rast.series input=tempmean_monthly \
92           method=average output=tempmean_january \
93           where="strftime(’%m’, start_time)=’01’"
94       # equivalently, we can use
95       t.rast.series input=tempmean_monthly \
96           output=tempmean_january method=average \
97           where="start_time = datetime(start_time, ’start of year’, ’0 month’)"
98       # if we want also February and March averages
99       t.rast.series input=tempmean_monthly \
100           output=tempmean_february method=average \
101           where="start_time = datetime(start_time, ’start of year’, ’1 month’)"
102       t.rast.series input=tempmean_monthly \
103           output=tempmean_march method=average \
104           where="start_time = datetime(start_time, ’start of year’, ’2 month’)"
105       Generalizing a bit, we  can  estimate  monthly  climatologies  for  all
106       months by means of different methods
107       for i in `seq -w 1 12` ; do
108         for m in average stddev minimum maximum ; do
109           t.rast.series input=tempmean_monthly method=${m} output=tempmean_${m}_${i} \
110           where="strftime(’%m’, start_time)=’${i}’"
111         done
112       done
113

AUTHOR

120       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
121
122       Last changed: $Date: 2016-01-13 00:28:48 +0100 (Wed, 13 Jan 2016) $
123

SOURCE CODE

125       Available at: t.rast.series source code (history)
126
127       Main index | Temporal index | Topics index | Keywords index | Graphical
128       index | Full index
129
130       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
131
132
133
134GRASS 7.6.0                                                   t.rast.series(1)