1t.list(1) GRASS GIS 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,...]] [or‐
16 der=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, semantic_label, creator, mapset, number_of_maps,
55 creation_time, start_time, end_time, interval, north, south, west,
56 east, granularity
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, semantic_label, creator, mapset, number_of_maps,
64 creation_time, start_time, end_time, north, south, west, east,
65 granularity, all
66 Default: id
67
68 where=sql_query
69 WHERE conditions of SQL statement without ’where’ keyword used in
70 the temporal GIS framework
71 Example: start_time > ’2001-01-01 12:30:00’
72
73 separator=character
74 Field separator character between the output columns
75 Special characters: pipe, comma, space, tab, newline
76 Default: pipe
77
78 output=name
79 Name for output file
80
82 t.list lists any dataset that is registered in the temporal database.
83 Datasets are raster, 3D raster and vector maps as well as their corre‐
84 sponding space time datasets (STRDS, STR3DS and STVDS). The type of the
85 dataset can be specified using the type option, default is STRDS. By
86 default all datasets with relative and absolute time are listed. How‐
87 ever, the user has the ability to specify a single temporal type with
88 the temporaltype option. The user can define the columns that should be
89 printed for each dataset and the order of the datasets. In addition a
90 SQL WHERE statement can be specified to select a subset of the re‐
91 quested datasets.
92
94 The SQL where and sort expression will be applied for each temporal
95 database that was found in accessible mapsets. Hence sorting works only
96 on mapset basis.
97
98 Temporal databases stored in other mapsets can be used as long as they
99 are in the user’s current mapset search path (managed with g.mapsets).
100
102 Obtain the list of space time raster dataset(s):
103 t.list strds
104 ----------------------------------------------
105 Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
106 tempmean_monthly@climate_2000_2012
107 Obtain the list of space time raster datasets in a specific mapset
108 (Note that the target mapset must be in the user’s search path):
109 # strds in PERMANENT
110 t.list strds where="mapset = ’PERMANENT’"
111 ----------------------------------------------
112 # strds in climate_2000_2012
113 t.list strds where="mapset = ’climate_2000_2012’"
114 ----------------------------------------------
115 Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
116 precip_abs@climate_2000_2012
117 precipitation@climate_2000_2012
118 tempmean@climate_2000_2012
119 The where option can also be used to list the stds with a certain pat‐
120 tern in their name, i.e. as the pattern option in g.list.
121 # strds whose name start with "precip"
122 t.list type=strds where="name LIKE ’precip%’"
123 ----------------------------------------------
124 Space time raster datasets with absolute time available in mapset <climate_1970_2012>:
125 precip_abs@climate_1970_2012
126 precipitation@climate_1970_2012
127 The user can also obtain the list of time stamped raster maps. These
128 maps might be registered in strds or not. The output of the following
129 command can vary according to the accessible mapsets specified through
130 g.mapsets.
131 t.list raster
132 Time stamped raster maps with absolute time available in mapset <climate_2000_2012>:
133 2009_01_tempmean@climate_2000_2012
134 2009_02_tempmean@climate_2000_2012
135 2009_03_tempmean@climate_2000_2012
136 ...
137 2012_10_tempmean@climate_2000_2012
138 2012_11_tempmean@climate_2000_2012
139 2012_12_tempmean@climate_2000_2012
140
142 g.list, t.create, t.info, t.rast.list, t.rast3d.list, t.vect.list
143
145 Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
146
148 Available at: t.list source code (history)
149
150 Accessed: Saturday Oct 28 18:19:22 2023
151
152 Main index | Temporal index | Topics index | Keywords index | Graphical
153 index | Full index
154
155 © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
156
157
158
159GRASS 8.3.1 t.list(1)