t.remove(1grass)

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

✨ t.remove — the manual page, but make it cute ✨

okay bestie, welcome to t.remove(1grass) 💖 this one lives in the GRASS User's Manual and it's genuinely one of the most satisfying little commands ever, because it's literally just... deleting things. main character energy fr.

🎀 NAME 🎀

t.remove — removes space time datasets from the temporal database. yes. it deletes them. that's the whole gig bestie 💅

🔑 KEYWORDS 🔑

temporal, map management, remove, time — the four-word vibe check for this page 🌸

📜 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 the temporal database. recursive girlie behavior, lowkey iconic 🌈
  • -f — force removal. this one is required for actual deletion of files, no cap 🔥
  • -d — remove stds, unregister maps from the temporal database and delete them from mapset. the full send, the deluxe package 💀
  • --help — print usage summary. when u need the recap 🫶
  • --verbose — verbose module output. it will tell u EVERYTHING 🌸
  • --quiet — quiet module output. it will tell u NOTHING 🤫
  • --ui — force launching GUI dialog. for when u want buttons instead of typing 💅

🧚 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, the module t.remove removes space time datasets (STRDS, STR3DS, STVDS) from the temporal database. in other words bestie, by default it deletes the relevant database entries ✨ It can also unregister maps from the temporal database using the recursive mode -r (recursive). like, two-for-one behavior, obsessed 🫶

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. so yes, the files themselves, not just the bookkeeping 🦋

⚠️ all removals only work if the -f (force) flag is used. literally none of it happens without -f. it's the password. it's the vibe check u have to pass. do not forget the -f, bestie, i am begging 😭

🌟 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 how -df goes full send and -f alone is the gentle version 🥰 that's the whole arc of this example. ate.

👀 SEE ALSO 👀

t.create, t.info, t.register — go read those too, they're the friend group 💜

👑 AUTHOR 👑

Sören Gebbert, Thünen Institute of Climate-Smart Agriculture. thank u for ur service king 🫡

💻 SOURCE CODE 💻

Available at: t.remove source code (history)

Latest change: Thursday Dec 18 07:11:47 2025 in commit: cf870a5e49fd2643a55de543467edf5c2e61d640

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

and that's the whole page bestie, u made it to the end, slay 💅✨

signing off with the important bits: © 2003-2026 GRASS Development Team, this is the GRASS 8.5.0 Reference Manual, and t.remove(1grass) is labeled GRASS 8.5.0 at the bottom of the page. periodt. 🎀🦋💖

📦 where this page comes from