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

NAME

6       t.rast.list  - Lists registered maps of a space time raster dataset.
7

KEYWORDS

9       temporal, map management, raster, list, time
10

SYNOPSIS

12       t.rast.list
13       t.rast.list --help
14       t.rast.list   [-u]   input=name    [order=string[,string,...]]    [col‐
15       umns=string[,string,...]]       [where=sql_query]       [method=string]
16       [granule=string]     [separator=character]    [output=name]    [--over‐
17       write]  [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       -u
21           Suppress printing of column names
22
23       --overwrite
24           Allow output files to overwrite existing files
25
26       --help
27           Print usage summary
28
29       --verbose
30           Verbose module output
31
32       --quiet
33           Quiet module output
34
35       --ui
36           Force launching GUI dialog
37
38   Parameters:
39       input=name [required]
40           Name of the input space time raster dataset
41
42       order=string[,string,...]
43           Sort the space time dataset by category
44           Options: id, name, creator, mapset,  temporal_type,  creation_time,
45           start_time, end_time, north, south, west, east, nsres, ewres, cols,
46           rows, number_of_cells, min, max
47           Default: start_time
48
49       columns=string[,string,...]
50           Columns to be printed to stdout
51           Options: id, name, creator, mapset,  temporal_type,  creation_time,
52           start_time, end_time, north, south, west, east, nsres, ewres, cols,
53           rows, number_of_cells, min, max
54           Default: name,mapset,start_time,end_time
55
56       where=sql_query
57           WHERE conditions of SQL statement without ’where’ keyword  used  in
58           the temporal GIS framework
59           Example: start_time > ’2001-01-01 12:30:00’
60
61       method=string
62           Method used for data listing
63           Options: cols, comma, delta, deltagaps, gran
64           Default: cols
65
66       granule=string
67           The  granule  to be used for listing. The granule must be specified
68           as string eg.: absolute time "1 months" or relative time "1"
69
70       separator=character
71           Field separator character between the output columns
72           Special characters: pipe, comma, space, tab, newline
73           Default: pipe
74
75       output=name
76           Name for output file
77

DESCRIPTION

79       List time stamped raster map layers that are registered in a space time
80       raster dataset. t.rast.list provides several options to list map layers
81       and their metadata. Listing of map layer can be  ordered  by  metadata,
82       metadata  columns can be specified and SQL where conditions can be pro‐
83       vided to select a map layer subset  of  the  input  space  time  raster
84       dataset. Most of the raster map  specific metadat is available for col‐
85       umn selection, sorting and SQL  where  statements.   Using  the  method
86       option  allows  the specification of different methods to list map lay‐
87       ers. Method col is the default option and sensitive to the column,order
88       and  where  options.  It will simply print user specified metadata col‐
89       umns of one map layer per line. The comma  method  will  list  the  map
90       layer  as  comma  separated  list that can be used as input for spatial
91       modules.
92
93       To print interval length in days and distance from the begin use method
94       delta.  Method  deltagap  will additionally print temporal gaps between
95       map layer. The gran method allows the listing of map layer sampled by a
96       user  defined  granule.  As  default  the granularity of the space time
97       raster dataset is used for sampling.  The output column  separator  can
98       be specified with the separator option.
99

EXAMPLES

101       This  example  shows  several options that are available for map layers
102       listing.
103
104   Default query
105       The following command is the default one, returning  standard  informa‐
106       tion  like  name, mapset, start_time, end_time of each map in the space
107       time dataset
108
109       t.rast.list tempmean_monthly
110       name|mapset|start_time|end_time
111       2009_01_tempmean|climate_2000_2012|2009-01-01 00:00:00|2009-02-01 00:00:00
112       2009_02_tempmean|climate_2000_2012|2009-02-01 00:00:00|2009-03-01 00:00:00
113       ....
114       2012_11_tempmean|climate_2000_2012|2012-11-01 00:00:00|2012-12-01 00:00:00
115       2012_12_tempmean|climate_2000_2012|2012-12-01 00:00:00|2013-01-01 00:00:00
116
117   Add more info
118       The following command let the user to choose the columns to show
119
120       t.rast.list tempmean_monthly columns=name,start_time,min,max
121       name|start_time|min|max
122       2009_01_tempmean|2009-01-01 00:00:00|-3.380823|7.426054
123       2009_02_tempmean|2009-02-01 00:00:00|-1.820261|8.006386
124       ...
125       2009_01_tempmean|2009-01-01 00:00:00|-3.380823|7.426054
126       2009_02_tempmean|2009-02-01 00:00:00|-1.820261|8.006386
127
128   Filtering the result by value
129       In this example the result is filtered showing only the maps  with  max
130       value major than 24
131
132       t.rast.list tempmean_monthly columns=name,start_time,min,max where="max > 24"
133       name|start_time|min|max
134       2009_06_tempmean|2009-06-01 00:00:00|15.962669|25.819681
135       2009_07_tempmean|2009-07-01 00:00:00|15.32852|26.103664
136       2009_08_tempmean|2009-08-01 00:00:00|16.37995|27.293282
137       ....
138       2012_06_tempmean|2012-06-01 00:00:00|14.929379|24.000651
139       2012_07_tempmean|2012-07-01 00:00:00|18.455802|28.794653
140       2012_08_tempmean|2012-08-01 00:00:00|15.718526|26.151115
141
142   Filtering the result by time range
143       In this example the result is filtered showing only the maps which fall
144       into a specified time range (from .. to):
145
146       t.rast.list tempmean_monthly columns=name,start_time,min,max \
147         where="start_time > ’2009-06-01 00:00:00’ and start_time < ’2012-08-01 00:00:00’"
148       name|start_time|min|max
149       2009_06_tempmean|2009-06-01 00:00:00|15.962669|25.819681
150       2009_07_tempmean|2009-07-01 00:00:00|15.32852|26.103664
151       2009_08_tempmean|2009-08-01 00:00:00|16.37995|27.293282
152       ....
153       2012_06_tempmean|2012-06-01 00:00:00|14.929379|24.000651
154       2012_07_tempmean|2012-07-01 00:00:00|18.455802|28.794653
155       2012_08_tempmean|2012-08-01 00:00:00|15.718526|26.151115
156
157   Filtering the result by selecting recurring timestamps
158       In this example the result is filtered showing only the maps which fall
159       into a specified recurring time range (here one month per year):
160       t.rast.list Tseasonal_fieldata_garda where="strftime(’%m’, start_time)=’06’"
161
162   Using method option
163       Method  option is able to show raster in different way. By default cols
164       value is used, the value comma will print only the list of maps  inside
165       the space time dataset:
166
167       t.rast.list method=comma input=tempmean_monthly
168       2009_01_tempmean@climate_2009_2012,2009_02_tempmean@climate_2009_2012,2009_03_tempmean@climate_2009_2012, \
169       2009_04_tempmean@climate_2009_2012,2009_05_tempmean@climate_2009_2012,2009_06_tempmean@climate_2009_2012, \
170       2009_07_tempmean@climate_2009_2012,2009_08_tempmean@climate_2009_2012,2009_09_tempmean@climate_2009_2012, \
171       2009_10_tempmean@climate_2009_2012,2009_11_tempmean@climate_2009_2012,2009_12_tempmean@climate_2009_2012, \
172       2010_01_tempmean@climate_2009_2012,2010_02_tempmean@climate_2009_2012,2010_03_tempmean@climate_2009_2012, \
173       2010_04_tempmean@climate_2009_2012,2010_05_tempmean@climate_2009_2012,2010_06_tempmean@climate_2009_2012, \
174       2010_07_tempmean@climate_2009_2012,2010_08_tempmean@climate_2009_2012,2010_09_tempmean@climate_2009_2012, \
175       2010_10_tempmean@climate_2009_2012,2010_11_tempmean@climate_2009_2012,2010_12_tempmean@climate_2009_2012, \
176       2011_01_tempmean@climate_2009_2012,2011_02_tempmean@climate_2009_2012,2011_03_tempmean@climate_2009_2012, \
177       2011_04_tempmean@climate_2009_2012,2011_05_tempmean@climate_2009_2012,2011_06_tempmean@climate_2009_2012, \
178       2011_07_tempmean@climate_2009_2012,2011_08_tempmean@climate_2009_2012,2011_09_tempmean@climate_2009_2012, \
179       2011_10_tempmean@climate_2009_2012,2011_11_tempmean@climate_2009_2012,2011_12_tempmean@climate_2009_2012, \
180       2012_01_tempmean@climate_2009_2012,2012_02_tempmean@climate_2009_2012,2012_03_tempmean@climate_2009_2012, \
181       2012_04_tempmean@climate_2009_2012,2012_05_tempmean@climate_2009_2012,2012_06_tempmean@climate_2009_2012, \
182       2012_07_tempmean@climate_2009_2012,2012_08_tempmean@climate_2009_2012,2012_09_tempmean@climate_2009_2012, \
183       2012_10_tempmean@climate_2009_2012,2012_11_tempmean@climate_2009_2012,2012_12_tempmean@climate_2009_2012
184       The  delta  value  calculate the interval between maps and the distance
185       from the first map:
186
187       t.rast.list method=delta input=tempmean_monthly
188       id|name|mapset|start_time|end_time|interval_length|distance_from_begin
189       2009_01_tempmean@climate_2000_2012|2009_01_tempmean|climate_2000_2012|2009-01-01 00:00:00|2009-02-01 00:00:00|31.0|0.0
190       2009_02_tempmean@climate_2000_2012|2009_02_tempmean|climate_2000_2012|2009-02-01 00:00:00|2009-03-01 00:00:00|28.0|31.0
191       2009_03_tempmean@climate_2000_2012|2009_03_tempmean|climate_2000_2012|2009-03-01 00:00:00|2009-04-01 00:00:00|31.0|59.0
192       ...
193       2012_10_tempmean@climate_2000_2012|2012_10_tempmean|climate_2000_2012|2012-10-01 00:00:00|2012-11-01 00:00:00|31.0|1369.0
194       2012_11_tempmean@climate_2000_2012|2012_11_tempmean|climate_2000_2012|2012-11-01 00:00:00|2012-12-01 00:00:00|30.0|1400.0
195       2012_12_tempmean@climate_2000_2012|2012_12_tempmean|climate_2000_2012|2012-12-01 00:00:00|2013-01-01 00:00:00|31.0|1430.0
196       The gran value it is used to return data  sampled  by  a  user  defined
197       granule. As default the granularity of the space time raster dataset is
198       used for sampling.
199
200       t.rast.list  method=gran input=tempmean_monthly
201       id|name|mapset|start_time|end_time|interval_length|distance_from_begin
202       2009_01_tempmean@climate_2009_2012|2009_01_tempmean|climate_2009_2012|2009-01-01 00:00:00|2009-02-01 00:00:00|31.0|0.0
203       2009_02_tempmean@climate_2009_2012|2009_02_tempmean|climate_2009_2012|2009-02-01 00:00:00|2009-03-01 00:00:00|28.0|31.0
204       2009_03_tempmean@climate_2009_2012|2009_03_tempmean|climate_2009_2012|2009-03-01 00:00:00|2009-04-01 00:00:00|31.0|59.0
205       2009_04_tempmean@climate_2009_2012|2009_04_tempmean|climate_2009_2012|2009-04-01 00:00:00|2009-05-01 00:00:00|30.0|90.0
206       ....
207       2012_09_tempmean@climate_2009_2012|2012_09_tempmean|climate_2009_2012|2012-09-01 00:00:00|2012-10-01 00:00:00|30.0|1339.0
208       2012_10_tempmean@climate_2009_2012|2012_10_tempmean|climate_2009_2012|2012-10-01 00:00:00|2012-11-01 00:00:00|31.0|1369.0
209       2012_11_tempmean@climate_2009_2012|2012_11_tempmean|climate_2009_2012|2012-11-01 00:00:00|2012-12-01 00:00:00|30.0|1400.0
210       2012_12_tempmean@climate_2009_2012|2012_12_tempmean|climate_2009_2012|2012-12-01 00:00:00|2013-01-01 00:00:00|31.0|1430.0
211
212       t.rast.list  method=gran input=tempmean_monthly gran="2 months"
213       id|name|mapset|start_time|end_time|interval_length|distance_from_begin
214       2009_01_tempmean@climate_2009_2012|2009_01_tempmean|climate_2009_2012|2009-01-01 00:00:00|2009-03-01 00:00:00|59.0|0.0
215       2009_03_tempmean@climate_2009_2012|2009_03_tempmean|climate_2009_2012|2009-03-01 00:00:00|2009-05-01 00:00:00|61.0|59.0
216       2009_05_tempmean@climate_2009_2012|2009_05_tempmean|climate_2009_2012|2009-05-01 00:00:00|2009-07-01 00:00:00|61.0|120.0
217       ....
218       2012_07_tempmean@climate_2009_2012|2012_07_tempmean|climate_2009_2012|2012-07-01 00:00:00|2012-09-01 00:00:00|62.0|1277.0
219       2012_09_tempmean@climate_2009_2012|2012_09_tempmean|climate_2009_2012|2012-09-01 00:00:00|2012-11-01 00:00:00|61.0|1339.0
220       2012_11_tempmean@climate_2009_2012|2012_11_tempmean|climate_2009_2012|2012-11-01 00:00:00|2013-01-01 00:00:00|61.0|1400.0
221       For the deltagaps value you can see the example for space  time  vector
222       dataset t.vect.list
223

SEE ALSO

225        g.list, t.create, t.info, t.list, t.rast3d.list, t.vect.list
226
227       Temporal data processing Wiki
228

AUTHOR

230       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
231

SOURCE CODE

233       Available at: t.rast.list source code (history)
234
235       Main index | Temporal index | Topics index | Keywords index | Graphical
236       index | Full index
237
238       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
239
240
241
242GRASS 7.8.2                                                     t.rast.list(1)
Impressum