t.vect.extract(1grass)

✨ t.vect.extract 💖

okay bestie, gather round, because this is the t.vect.extract page from the GRASS User's Manual (that's the 1grass manual, section 1, we been knew) and it's literally about scooping a lil subset out of a space time vector dataset and dropping it into a whole new space time vector dataset. it's giving "cut a slice, serve it on a new plate". 🍰

🌸 NAME 🌸

t.vect.extract — extracts a subset of a space time vector dataset.

🔑 KEYWORDS 🔑

temporal, extract, vector, time

📜 SYNOPSIS 📜

t.vect.extract
t.vect.extract --help
t.vect.extract [-n] input=name  [where=sql_query]
[expression=sql_query]  output=name  [layer=string]
[type=string[,string,...]]   [basename=string]   [suffix=name]
[nprocs=integer]   [--overwrite]  [--help]  [--verbose]  [--quiet]
[--ui]

🚩 Flags 🚩

• -n — register empty maps (yes, even the empty ones get an invite to the party 💌)
• --overwrite — allow output files to overwrite existing files (no cap, it will just bulldoze them 💀)
• --help — print usage summary
• --verbose — verbose module output (chatty era 🗣️)
• --quiet — quiet module output (silent era 🤫)
• --ui — force launching GUI dialog

🎀 Parameters 🎀

• input=name [required] — name of the input space time vector dataset
• 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'
• expression=sql_query — WHERE conditions of SQL statement without 'where' keyword
  • Example: income < 1000 and population >= 10000
• output=name [required] — name of the output space time vector dataset
• layer=string — layer number or name
  • vector features can have category values in different layers, so this number decides which layer to use. when you're rolling with direct OGR access, this here is the layer name. 🗂️
  • Default: 1
• type=string[,string,...] — input feature type
  • Options: point, line, boundary, centroid, area
  • Default: point,line,boundary,centroid,area
• basename=string — basename of the new generated output maps
  • a numerical suffix separated by an underscore will be attached to create a unique identifier
• suffix=name — suffix to add at basename: set 'gran' for granularity, 'time' for the full time format, 'num' for numerical suffix with a specific number of digits (default %%05)
  • Default: gran
• nprocs=integer — the number of v.extract processes to run in parallel. use only if database backend is used which supports concurrent writing
  • Default: 1

---

💅 DESCRIPTION 💅

so the whole vibe of t.vect.extract is: extract a subset of a space time vector dataset, and store that subset in a different space time vector dataset. that's it, that's the mission. iconic behavior honestly. ✨

🌈 EXAMPLE 🌈

in the following example a new space time vector dataset will be created with all the data later than the year 2000:

t.vect.extract input=shoreline where="start_time > 2000" \
               output=shoreline_later_2000 basename=new_shoreline

t.info shoreline_later_2000@shoreline type=stvds

 +-------------------- Space Time Vector Dataset -----------------------------+
 |                                                                            |
 +-------------------- Basic information -------------------------------------+
 | Id: ........................ shoreline_later_2000@shoreline
 | Name: ...................... shoreline_later_2000
 | Mapset: .................... shoreline
 | Creator: ................... lucadelu
 | Temporal type: ............. relative
 | Creation time: ............. 2014-11-29 08:43:50.043219
 | Modification time:.......... 2014-11-29 08:43:50.085407
 | Semantic type:.............. mean
 +-------------------- Relative time -----------------------------------------+
 | Start time:................. 2003
 | End time:................... 2009
 | Relative time unit:......... years
 | Granularity:................ 1
 | Temporal type of maps:...... point
 +-------------------- Spatial extent ----------------------------------------+
 | North:...................... 1039175.31479
 | South:...................... 34705.216018
 | East:.. .................... 3052322.44671
 | West:....................... 2130004.16779
 | Top:........................ 0.0
 | Bottom:..................... 0.0
 +-------------------- Metadata information ----------------------------------+
 | Vector register table:...... vector_map_register_8395740fc8de42149fef74a3d25bbb05
 | Number of points ........... 0
 | Number of lines ............ 407
 | Number of boundaries ....... 0
 | Number of centroids ........ 0
 | Number of faces ............ 0
 | Number of kernels .......... 0
 | Number of primitives ....... 407
 | Number of nodes ............ 767
 | Number of areas ............ 0
 | Number of islands .......... 0
 | Number of holes ............ 0
 | Number of volumes .......... 0
 | Number of registered maps:.. 3
 |
 | Title:
 | North Carolina shoreline
 | Description:
 | North Caroline shoreline from 2000 to 2009
 | Command history:
 | # 2014-11-29 08:43:50
 | t.vect.extract input="shoreline"
 |     where="start_time > 2000" output="shoreline_later_2000"
 |     basename="new_shoreline"
 | # 2014-11-29 08:44:14
 | t.support type="stvds"
 |     input="shoreline_later_2000@shoreline"
 |     descr="North Caroline shoreline from 2000 to 2009"
 +----------------------------------------------------------------------------+

t.vect.list shoreline_later_2000
name|layer|mapset|start_time|end_time
shoreline_2003|None|shoreline|2003|None
shoreline_2004|None|shoreline|2004|None
shoreline_2009|None|shoreline|2009|None

---

👀 SEE ALSO 👀

t.create, t.info

🫶 AUTHOR 🫶

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

⭐ SOURCE CODE ⭐

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

latest change: Tuesday Jan 27 12:40:13 2026 in commit: 5e8b13d47dd4fc81efa5abefe90c34f7a8291fb9

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

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

and that's the whole page bestie, you ate that 💅✨ — this was t.vect.extract(1grass) from the GRASS 8.5.0 manual, and that footer energy is all yours: GRASS 8.5.0, t.vect.extract(1grass). go extract something gorgeous. 🦋💜