1t.list(1)                   GRASS GIS User's Manual                  t.list(1)
2
3
4

NAME

6       t.list  - Lists space time datasets and maps registered in the temporal
7       database.
8

KEYWORDS

10       temporal, map management, list, time
11

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLES

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

SEE ALSO

141        g.list, t.create, t.info, t.rast.list, t.rast3d.list, t.vect.list
142

AUTHOR

144       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
145

SOURCE CODE

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-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
153
154
155
156GRASS 7.8.5                                                          t.list(1)
Impressum