GRASS logo

Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current manual page.


t.remove - Removes space time datasets from temporal database.


temporal, map management, remove, time


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


Remove all registered maps from the temporal and also from the spatial database
Force recursive removing
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


Name of the input space time datasets
Type of the space time dataset, default is strds
Options: strds, str3ds, stvds
Default: strds
Input file with dataset names, one per line

Table of contents


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 but not the maps.

Optionally, also the raster, 3D raster and vector maps of the space time datasets can be removed from the current mapset using the -r (recursive) and -f (force) flags. This recursive removal only works if both flags are checked together (use -rf).


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 location"

#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 -rf type=strds input=precip_years_sum

# b) the STRDS with 1 months granularity, but not the original sample data
t.remove type=strds input=precip_months_sum


t.create,, t.register


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


Available at: t.remove source code (history)

Latest change: Monday Nov 18 20:15:32 2019 in commit: 1a1d107e4f6e1b846f9841c2c6fabf015c5f720d

Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current manual page.

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

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.9dev Reference Manual