t.remove(1)

✨ t.remove ✨

okay bestie, welcome to the GRASS GIS User's Manual, section 1 — this is the t.remove page and it's literally about deleting your space time datasets. slay.

---

💖 NAME 💖

t.remove — removes space time datasets from the temporal database. that's it, that's the job. 🗑️✨

---

🌸 KEYWORDS 🌸

temporal, map management, remove, time

---

🦋 SYNOPSIS 🦋

t.remove
t.remove --help
t.remove [-rfd]  [inputs=name[,name,...]]   [type=string]   [file=name]
[--help]  [--verbose]  [--quiet]  [--ui]

---

🎀 Flags 🎀

• -r — remove stds and unregister maps from temporal database. the recursive one, she goes deep 💅
• -f — force removal (required for actual deletion of files). no force, no delete, periodt.
• -d — remove stds, unregister maps from temporal database and delete them from mapset. she's not just ghosting, she's blocking too 😭
• --help — print usage summary
• --verbose — verbose module output
• --quiet — quiet module output
• --ui — force launching GUI dialog

---

🧚 Parameters 🧚

• inputs=name[,name,...] — name of the input space time datasets
• type=string — type of the space time dataset, default is strds
  • Options: strds, str3ds, stvds
  • Default: strds
• file=name — input file with dataset names, one per line

---

💜 DESCRIPTION 💜

so basically the module t.remove removes space time datasets (STRDS, STR3DS, STVDS) from the temporal database. in other words, by default it deletes the relevant database entries. it can also unregister maps from the temporal database using the recursive mode -r (recursive). 👑

optionally, also the raster, 3D raster and vector maps of the space time datasets can be removed from the current mapset using the -d (delete) flag. and listen — all removals only work if the -f (force) flag is used. no cap. 🚨

---

🌈 EXAMPLE 🌈

in this example a space time raster dataset (STRDS) named precip_months_sum will be created using a subset of the monthly precipitation raster maps from the North Carolina climate sample data set.

in order to be able to show the case of recursive removal without deleting the original sample data, we generate new data by means of computing yearly precipitation sums. eventually, all newly produced data (STRDS and raster maps) are removed: 💫

# Create new and empty STRDS
t.create output=precip_months_sum semantictype=mean \
  title="Monthly sum of precipitation" \
  description="Monthly sum of precipitation for the \
  North Carolina sample data"
# Register maps from sample dataset (selecting a subset with g.list)
t.register -i type=raster input=precip_months_sum \
  maps=$(g.list type=raster pattern="201*_precip" separator=comma) \
  start="2010-01-01" increment="1 months"
# Create some new data by aggregating with 1 years granularity
t.rast.aggregate input=precip_months_sum \
  output=precip_years_sum basename=precip_years_sum \
  granularity="1 years" method=sum
# Remove all newly produced data:
# a) the aggregated STRDS with 1 years granularity along with its raster maps
t.remove -df type=strds input=precip_years_sum
# b) the STRDS with 1 months granularity, but not the original sample data
t.remove -f type=strds input=precip_months_sum

---

⭐ SEE ALSO ⭐

t.create, t.info, t.register

---

👑 AUTHOR 👑

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

---

💀 SOURCE CODE 💀

available at: t.remove 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 bestie 🫶 this was GRASS 8.4.2, t.remove(1), and honestly? iconic. go delete responsibly, mwah 💅🍓