[GRASS-SVN] r61942 - grass/trunk/temporal/t.remove

[svn_grass at osgeo.org]

Author: neteler
Date: 2014-09-13 19:28:48 -0700 (Sat, 13 Sep 2014)
New Revision: 61942

Modified:
   grass/trunk/temporal/t.remove/t.remove.html
Log:
t.remove manual: updated manual by Stefan Blumentrath

Modified: grass/trunk/temporal/t.remove/t.remove.html
===================================================================
--- grass/trunk/temporal/t.remove/t.remove.html	2014-09-14 02:15:47 UTC (rev 61941)
+++ grass/trunk/temporal/t.remove/t.remove.html	2014-09-14 02:28:48 UTC (rev 61942)
@@ -1,12 +1,53 @@
 <h2>DESCRIPTION</h2>
 
-TBD.
+The module <em>t.remove</em> removes space time datasets (strds, str3ds, 
+stvds) from the temporal database. In other words, it deletes the relevant 
+database entries and not the maps.
+<p>
+Optionally, also the raster, 3D raster and vector maps of the space time 
+datasets can be removed using the <b>-r</b> (recursive) and <b>-f</b>
+(force) flags. Recursive removal works only if both flags are checked
+(use <b>-rf</b>).
 
+<h2>EXAMPLE</h2>
+
+In this example we create a space time raster dataset (strds) named 
+<b>precip_months_sum</b> using a subset of the monthly precipitation 
+raster maps from the North Carolina climate sample data set. In order to 
+be able to show case recursive removal without deleting original sample 
+data, new data is generated by means of computing yearly precipitation sums. 
+Finally, all newly produced data (strds and raster maps) is removed again.
+
+<div class="code"><pre>
+#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.mlist)
+t.register -i type=rast input=precip_months_sum \
+  maps=$(g.mlist type=rast 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 together 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
+</pre></div>
+
 <h2>SEE ALSO</h2>
 
 <em>
 <a href="t.create.html">t.create</a>,
-<a href="t.info.html">t.info</a>
+<a href="t.register.html">t.register</a>
 </em>
 
 <h2>AUTHOR</h2>