t.list(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 t.list 💖

okay bestie, welcome to t.list from the GRASS GIS User's Manual (section 1, as in t.list(1), iykyk) 🦋

✨ NAME ✨

t.list — lists space time datasets and maps registered in the temporal database. that's it, that's the whole job, and she does it flawlessly 💅

🌸 KEYWORDS 🌸

temporal, map management, list, time

🎀 SYNOPSIS 🎀

t.list
t.list --help
t.list [-c]  [type=string]   [temporaltype=name[,name,...]]
[order=string[,string,...]]   [columns=string[,string,...]]
[where=sql_query]   [separator=character]   [output=name]
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags:

  • -c — print the column names as the first row. header girlie behavior, we love her 🫶
  • --overwrite — allow output files to overwrite existing files. she will absolutely bulldoze what's already there, so be careful, no cap 💀
  • --help — print usage summary
  • --verbose — verbose module output
  • --quiet — quiet module output
  • --ui — force launching GUI dialog

🧚 Parameters:

  • type=string — type of the space time dataset or map, default is strds
    • Options: strds, str3ds, stvds, raster, raster_3d, vector
    • Default: strds
  • temporaltype=name[,name,...] — the temporal type of the space time dataset
    • Options: absolute, relative
    • Default: absolute,relative
  • order=string[,string,...] — sort the space time dataset by category
    • heads up bestie: columns number_of_maps and granularity only available for space time datasets ⭐
    • Options: id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, interval, north, south, west, east, granularity
    • Default: id
  • columns=string[,string,...] — columns to be printed to stdout
    • same lil note: columns number_of_maps and granularity only available for space time datasets ✨
    • Options: id, name, semantic_label, creator, mapset, number_of_maps, creation_time, start_time, end_time, north, south, west, east, granularity, all
    • Default: id
  • where=sql_query — WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework
    • Example: start_time > '2001-01-01 12:30:00'
  • separator=character — field separator character between the output columns
    • Special characters: pipe, comma, space, tab, newline
    • Default: pipe
  • output=name — name for output file

🦋 DESCRIPTION 🦋

t.list lists any dataset that is registered in the temporal database. and when we say datasets, we mean raster, 3D raster and vector maps plus their corresponding space time datasets (STRDS, STR3DS and STVDS) 👑

you tell her which one you want with the type option, and the default is STRDS. by default she shows you all datasets with relative and absolute time, because she's generous like that 💖 but if you're feeling picky you can specify a single temporal type with the temporaltype option.

you can also define the columns that get printed for each dataset, and the order they show up in. and if that's not enough, you can drop a SQL WHERE statement in there to select just a subset of the datasets you asked for. she's giving full customization, main character energy, periodt 💅

🌈 NOTES 🌈

  • the SQL where and sort expression get applied for each temporal database that was found in accessible mapsets. which means sorting works only on a mapset basis. yeah, per-mapset, that's just how she runs 🫶
  • temporal databases stored in other mapsets can be used, as long as they're in the user's current mapset search path (you manage that with g.mapsets). so check your search path first, bestie 🧚

🌟 EXAMPLES 🌟

obtain the list of space time raster dataset(s):

t.list strds
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
tempmean_monthly@climate_2000_2012

obtain the list of space time raster datasets in a specific mapset (note that the target mapset must be in the user's search path):

# strds in PERMANENT
t.list strds where="mapset = 'PERMANENT'"
----------------------------------------------
# strds in climate_2000_2012
t.list strds where="mapset = 'climate_2000_2012'"
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_2000_2012>:
precip_abs@climate_2000_2012
precipitation@climate_2000_2012
tempmean@climate_2000_2012

the where option can also be used to list the stds with a certain pattern in their name, i.e. as the pattern option in g.list 😌

# strds whose name start with "precip"
t.list type=strds where="name LIKE 'precip%'"
----------------------------------------------
Space time raster datasets with absolute time available in mapset <climate_1970_2012>:
precip_abs@climate_1970_2012
precipitation@climate_1970_2012

you can also obtain the list of time stamped raster maps. these maps might be registered in strds or not. the output of the following command can vary according to the accessible mapsets specified through g.mapsets 👀

t.list raster
Time stamped raster maps with absolute time available in mapset <climate_2000_2012>:
2009_01_tempmean@climate_2000_2012
2009_02_tempmean@climate_2000_2012
2009_03_tempmean@climate_2000_2012
...
2012_10_tempmean@climate_2000_2012
2012_11_tempmean@climate_2000_2012
2012_12_tempmean@climate_2000_2012

💜 SEE ALSO 💜

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

go read those too, bestie, they're all iconic in their own way 🌸

👑 AUTHOR 👑

Sören Gebbert, Thünen Institute of Climate-Smart Agriculture — thank you for your service, king 🫡

⭐ SOURCE CODE ⭐

Available at: t.list source code (history)

Accessed: Saturday Jan 17 05:41:53 2026

Main index | Temporal index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

and that's the whole page, babe 🎀 this was GRASS 8.4.2, accessed Saturday Jan 17 05:41:53 2026, and honestly? she ate. now go list some datasets 💖✨🦋

📦 where this page comes from