t.list(1grass)

💖 t.list — the manual page, but make it a group chat 💖

okay so bestie, this is t.list from the GRASS User's Manual, and it's literally about listing your space time datasets and maps that are registered in the temporal database. no cap. let's get into it 🦋

✨ KEYWORDS ✨

temporal, map management, list, time

---

🎀 SYNOPSIS 🎀

like, here's the shape of the whole thing:

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 — prints the column names as the first row. like a lil header. 💅
• --overwrite — lets output files overwrite files that already exist. yes, it will actually do that. 🙈
• --help — prints the usage summary.
• --verbose — verbose module output, i.e. it yaps more.
• --quiet — quiet module output, i.e. it yaps less.
• --ui — forces launching the GUI dialog.

🌈 Parameters 🌈

• type=string — the type of the space time dataset or map. default is strds. options are: 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,...] — sorts the space time dataset by category. heads up bestie: the columns number_of_maps and granularity are 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,...] — the columns that get printed to stdout. same lil caveat: number_of_maps and granularity are 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 an SQL statement, without the where keyword, used in the temporal GIS framework. example: start_time > ’2001-01-01 12:30:00’
• separator=character — the field separator character between the output columns. special characters: pipe, comma, space, tab, newline. default: pipe
• output=name — name for output file

---

🧚 DESCRIPTION 🧚

so t.list lists any dataset that's registered in the temporal database. we're talking raster, 3D raster and vector maps, plus their corresponding space time datasets (STRDS, STR3DS and STVDS). 💖

you pick which type you want with the type option, and the default is STRDS. by default, all datasets with relative and absolute time get listed. but you have the ability to specify a single temporal type with the temporaltype option, periodt.

you can also define which columns get printed for each dataset, and the order of the datasets. and on top of that, a SQL WHERE statement can be specified to select a subset of the datasets you requested. obsessed. 🔥

---

👑 NOTES 👑

the SQL where and sort expression get applied for each temporal database that was found in accessible mapsets. so, lowkey important: sorting works only on a mapset basis.

temporal databases stored in other mapsets can be used as long as they're in the user's current mapset search path (which you manage with g.mapsets). iykyk. 🫶

---

💅 EXAMPLES 💅

get 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

get the list of space time raster datasets in a specific mapset 🦋

(note that the target mapset must be in the user's search path, bestie)

# 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

pattern matching in the name 🌸

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

time stamped raster maps 🎀

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

---

💜 AUTHOR 💜

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

---

✨ SOURCE CODE ✨

available at: t.list source code (history)

latest change: Monday Nov 03 07:16:48 2025 in commit: c96796774942e46bbababcd652d3986d4e295665

main index | temporal index | topics index | keywords index | graphical index | full index

---

and that's the whole thing bestie 💖 this was written against the © 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual — so if you're running GRASS 8.5.0, you're literally in the right place. slay, go list some datasets, periodt. 🎀✨🦋