t.vect.list(1grass)

📦
version 8.5.0 · 10 versions
, in alpine 3.24, ubuntu stonking

💅 t.vect.list — NAME 💅

okay so bestie, welcome to t.vect.list(1grass) ✨ this lil icon lists registered maps of a space time vector dataset. that's the whole job. she's simple, she's powerful, she ate 💖

🔑 KEYWORDS 🔑

temporal, map management, vector, list, time

🎀 SYNOPSIS 🎀

t.vect.list
t.vect.list --help
t.vect.list [-u] input=name  [order=string[,string,...]]
[columns=string[,string,...]]   [where=sql_query]   [method=string]
format=name  [separator=character]   [output=name]   [--overwrite]
[--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags 🚩

  • -u — suppress printing of column names (so no header row, just the goods 👀)
  • --overwrite — allow output files to overwrite existing files, no cap
  • --help — print usage summary
  • --verbose — verbose module output (she gets chatty 💬)
  • --quiet — quiet module output (she goes silent mode 🤫)
  • --ui — force launching GUI dialog

🌸 Parameters 🌸

  • input=name — [required] name of the input space time vector dataset. like, you HAVE to tell her which one bestie, there's no guessing 🫶
  • order=string[,string,...] — sort the space time dataset by category
    • Options: id, name, layer, creator, mapset, temporal_type, creation_time, start_time, end_time, north, south, west, east, points, lines, boundaries, centroids, faces, kernels, primitives, nodes, areas, islands, holes, volumes
    • Default: start_time
  • columns=string[,string,...] — columns to be printed to stdout
    • Options: id, name, layer, creator, mapset, temporal_type, creation_time, start_time, end_time, north, south, west, east, points, lines, boundaries, centroids, faces, kernels, primitives, nodes, areas, islands, holes, volumes
    • Default: name,layer,mapset,start_time,end_time
  • 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'
  • method=string — method used for data listing
    • Options: cols, comma, delta, deltagaps, gran
    • Default: cols
  • format=name — [required] output format
    • Options: plain, line, json, yaml, csv
    • Default: plain
    • plain: plain text output
    • line: comma separated list of map names
    • json: JSON (JavaScript Object Notation)
    • yaml: YAML (YAML Ain't Markup Language)
    • csv: CSV (Comma Separated Values)
  • 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 🦋

so t.vect.list gives you literally the same functionality as t.rast.list, no exaggeration. the ONE difference (and it's a big one for the vector girlies) is that it's the vector map layer metadata instead. same energy, different data type ✨

🌈 EXAMPLE 🌈

🍓 Default query

this example shows a relative space time vector dataset where the first three maps span a range of years, whereas the last five are valid only for one year:

t.vect.list shoreline@shoreline
name|layer|mapset|start_time|end_time
shoreline_1849_1873|None|shoreline|1849|1873
shoreline_1925_1946|None|shoreline|1925|1946
shoreline_1970_1988|None|shoreline|1970|1988
shoreline_1997|None|shoreline|1997|None
shoreline_1998|None|shoreline|1998|None
shoreline_2003|None|shoreline|2003|None
shoreline_2004|None|shoreline|2004|None
shoreline_2009|None|shoreline|2009|None

🧚 Using method option

the method option is able to show a vector in a different way. by default the cols value is used. the value deltagaps will print the delta between maps and also the gaps if they exist (like in this example, bestie):

t.vect.list method=deltagaps input=shoreline
id|name|layer|mapset|start_time|end_time|interval_length|distance_from_begin
shoreline_1849_1873@shoreline|shoreline_1849_1873|None|shoreline|1849|1873|24|0
None|None|None|None|1873|1925|52|24
shoreline_1925_1946@shoreline|shoreline_1925_1946|None|shoreline|1925|1946|21|76
None|None|None|None|1946|1970|24|97
shoreline_1970_1988@shoreline|shoreline_1970_1988|None|shoreline|1970|1988|18|121
None|None|None|None|1988|1997|9|139
shoreline_1997@shoreline|shoreline_1997|None|shoreline|1997|None|None|148
None|None|None|None|1997|1998|1|148
shoreline_1998@shoreline|shoreline_1998|None|shoreline|1998|None|None|149
None|None|None|None|1998|2003|5|149
shoreline_2003@shoreline|shoreline_2003|None|shoreline|2003|None|None|154
None|None|None|None|2003|2004|1|154
shoreline_2004@shoreline|shoreline_2004|None|shoreline|2004|None|None|155
None|None|None|None|2004|2009|5|155
shoreline_2009@shoreline|shoreline_2009|None|shoreline|2009|None|None|160

👀 SEE ALSO 👀

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

👑 AUTHOR 👑

Sören Gebbert

💖 SOURCE CODE 💖

available at: t.vect.list source code (history)

latest change: Thursday Feb 19 08:17:16 2026 in commit: f29eb55d509a61ac9fd053465a4db5d2e54b67b8

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

okay that's the whole page bestie, you're officially a t.vect.list scholar now 🎓✨ send this to the group chat, it's giving main character energy fr fr 💅🦋🌸

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual — and this came straight out of GRASS 8.5.0, with t.vect.list(1grass) living her best life at the bottom of the page 💜 periodt.

📦 where this page comes from