1t.rast.list(1) Grass User's Manual t.rast.list(1)
2
3
4
6 t.rast.list - Lists registered maps of a space time raster dataset.
7
9 temporal, map management, raster, list, time
10
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
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
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
225 g.list, t.create, t.info, t.list, t.rast3d.list, t.vect.list
226
227 Temporal data processing Wiki
228
230 Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
231
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)