1t.list(1) Grass User's Manual t.list(1)
2
3
4
6 t.list - Lists space time datasets and maps registered in the temporal
7 database.
8
10 temporal, map management, list, time
11
13 t.list
14 t.list --help
15 t.list [-c] [type=string] [temporaltype=name[,name,...]]
16 [order=string[,string,...]] [columns=string[,string,...]]
17 [where=sql_query] [separator=character] [output=name] [--over‐
18 write] [--help] [--verbose] [--quiet] [--ui]
19
20 Flags:
21 -c
22 Print the column names as first row
23
24 --overwrite
25 Allow output files to overwrite existing files
26
27 --help
28 Print usage summary
29
30 --verbose
31 Verbose module output
32
33 --quiet
34 Quiet module output
35
36 --ui
37 Force launching GUI dialog
38
39 Parameters:
40 type=string
41 Type of the space time dataset or map, default is strds
42 Options: strds, str3ds, stvds, raster, raster_3d, vector
43 Default: strds
44
45 temporaltype=name[,name,...]
46 The temporal type of the space time dataset
47 Options: absolute, relative
48 Default: absolute,relative
49
50 order=string[,string,...]
51 Sort the space time dataset by category
52 Columns number_of_maps and granularity only available for space
53 time datasets
54 Options: id, name, creator, mapset, number_of_maps, creation_time,
55 start_time, end_time, interval, north, south, west, east, granular‐
56 ity
57 Default: id
58
59 columns=string[,string,...]
60 Columns to be printed to stdout
61 Columns number_of_maps and granularity only available for space
62 time datasets
63 Options: id, name, creator, mapset, number_of_maps, creation_time,
64 start_time, end_time, north, south, west, east, granularity, all
65 Default: id
66
67 where=sql_query
68 WHERE conditions of SQL statement without ’where’ keyword used in
69 the temporal GIS framework
70 Example: start_time > ’2001-01-01 12:30:00’
71
72 separator=character
73 Field separator character between the output columns
74 Special characters: pipe, comma, space, tab, newline
75 Default: pipe
76
77 output=name
78 Name for output file
79
81 t.list lists any dataset that is registered in the temporal database.
82 Datasets are raster, 3D raster and vector maps as well as their corre‐
83 sponding space time datasets (STRDS, STR3DS and STVDS). The type of the
84 dataset can be specified using the type option, default is STRDS. By
85 default all datasets with relative and absolute time are listed. How‐
86 ever, the user has the ability to specify a single temporal type with
87 the temporaltype option. The user can define the columns that should be
88 printed for each dataset and the order of the datasets. In addition a
89 SQL WHERE statement can be specified to select a subset of the
90 requested datasets.
91
93 The SQL where and sort expression will be applied for each temporal
94 database that was found in accessible mapsets. Hence sorting works only
95 on mapset basis.
96
97 Temporal databases stored in other mapsets can be used as long as they
98 are in the user’s current mapset search path (managed with g.mapsets).
99
101 Obtain the list of space time raster dataset(s):
102 t.list strds
103 ----------------------------------------------
104 Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
105 tempmean_monthly@climate_2000_2012
106 Obtain the list of space time raster datasets in a specific mapset
107 (Note that the target mapset must be in the user’s search path):
108 # strds in PERMANENT
109 t.list strds where="mapset = ’PERMANENT’"
110 ----------------------------------------------
111 # strds in climate_2000_2012
112 t.list strds where="mapset = ’climate_2000_2012’"
113 ----------------------------------------------
114 Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
115 precip_abs@climate_2000_2012
116 precipitation@climate_2000_2012
117 tempmean@climate_2000_2012
118 The where option can also be used to list the stds with a certain pat‐
119 tern in their name, i.e. as the pattern option in g.list.
120 # strds whose name start with "precip"
121 t.list type=strds where="name LIKE ’precip%’"
122 ----------------------------------------------
123 Space time raster datasets with absolute time available in mapset <climate_1970_2012>:
124 precip_abs@climate_1970_2012
125 precipitation@climate_1970_2012
126 The user can also obtain the list of time stamped raster maps. These
127 maps might be registered in strds or not. The output of the following
128 command can vary according to the accessible mapsets specified through
129 g.mapsets.
130 t.list raster
131 Time stamped raster maps with absolute time available in mapset <climate_2000_2012>:
132 2009_01_tempmean@climate_2000_2012
133 2009_02_tempmean@climate_2000_2012
134 2009_03_tempmean@climate_2000_2012
135 ...
136 2012_10_tempmean@climate_2000_2012
137 2012_11_tempmean@climate_2000_2012
138 2012_12_tempmean@climate_2000_2012
139
141 g.list, t.create, t.info, t.rast.list, t.rast3d.list, t.vect.list
142
144 Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
145
147 Available at: t.list source code (history)
148
149 Main index | Temporal index | Topics index | Keywords index | Graphical
150 index | Full index
151
152 © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
153
154
155
156GRASS 7.8.2 t.list(1)