[GRASS-SVN] r62871 - in grass/trunk/temporal: t.connect t.create t.info t.list t.merge t.rast.accdetect t.rast.accumulate t.rast.aggregate t.rast.aggregate.ds t.rast.algebra t.rast.colors t.rast.export t.rast.extract t.rast.gapfill t.rast.import t.rast.list t.rast.mapcalc t.rast.neighbors t.rast.out.vtk t.rast.series t.rast.to.rast3
svn_grass at osgeo.org
svn_grass at osgeo.org
Sun Nov 23 08:12:54 PST 2014
Author: huhabla
Date: 2014-11-23 08:12:54 -0800 (Sun, 23 Nov 2014)
New Revision: 62871
Modified:
grass/trunk/temporal/t.connect/t.connect.html
grass/trunk/temporal/t.create/t.create.html
grass/trunk/temporal/t.info/t.info.html
grass/trunk/temporal/t.list/t.list.html
grass/trunk/temporal/t.merge/t.merge.html
grass/trunk/temporal/t.rast.accdetect/t.rast.accdetect.html
grass/trunk/temporal/t.rast.accumulate/t.rast.accumulate.html
grass/trunk/temporal/t.rast.aggregate.ds/t.rast.aggregate.ds.html
grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html
grass/trunk/temporal/t.rast.algebra/t.rast.algebra.html
grass/trunk/temporal/t.rast.colors/t.rast.colors.html
grass/trunk/temporal/t.rast.export/t.rast.export.html
grass/trunk/temporal/t.rast.extract/t.rast.extract.html
grass/trunk/temporal/t.rast.gapfill/t.rast.gapfill.html
grass/trunk/temporal/t.rast.import/t.rast.import.html
grass/trunk/temporal/t.rast.list/t.rast.list.html
grass/trunk/temporal/t.rast.mapcalc/t.rast.mapcalc.html
grass/trunk/temporal/t.rast.neighbors/t.rast.neighbors.html
grass/trunk/temporal/t.rast.out.vtk/t.rast.out.vtk.html
grass/trunk/temporal/t.rast.series/t.rast.series.html
grass/trunk/temporal/t.rast.series/t.rast.series.py
grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.html
grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.py
Log:
temporal modules: New manual pages added and existing manual pages updated.
Modified: grass/trunk/temporal/t.connect/t.connect.html
===================================================================
--- grass/trunk/temporal/t.connect/t.connect.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.connect/t.connect.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -1,31 +1,36 @@
<h2>DESCRIPTION</h2>
-<em>t.connect</em> allows the user to set the temporal GIS database connection.
+<em>t.connect</em> allows the user to set the temporal database connection.
+The default setting is that the temporal database of
+type sqlite3 is located in the current mapset directory.
-<h2>NOTES</h2>
-
-Values are stored in the mapset's <tt>VAR</tt> file; the connection is
-not tested for validity. <p>The <b>-d</b> flag will set the default
-TGIS connection parameters.
-<!-- TODO: really always PERMANENT? - see http://trac.osgeo.org/grass/ticket/2258 -->
-A SQLite3 database "tgis/sqlite.db" will be created in the PERMANENT directory
-of the current location. It will be located in the "tgis" sub-directory to not
-interfere with the sqlite3 database used for vector attribute storage.
-
-<p>The <b>-p</b> flag will display the current TGIS connection parameters.
-<p>The <b>-pg</b> flag will display the current TGIS connection parameters
+<p>The <b>-p</b> flag will display the current temporal database connection parameters.
+<p>The <b>-pg</b> flag will display the current temporal database connection parameters
using shell style.
-<p>The <b>-c</b> flag will silently check if the TGIS connection
+<p>The <b>-c</b> flag will silently check if the temporal database connection
parameters have been set, and if not will set them to use GRASS's
default values.
<h2>Note</h2>
-The default TGIS database of type sqlite3 is located in the PERMANENT
-mapset directory. Temporal GIS content from all created mapsets will be
-stored here. In case you have thousands of maps to register in the
+Setting the connection with t.connect will not test the connection for validity.
+Hence a database connection will not be established.
+<p>
+The connection values are stored in the mapset's <tt>VAR</tt> file.
+The <b>-d</b> flag will set the default
+TGIS connection parameters.
+A SQLite3 database "tgis/sqlite.db" will be created in the current mapset directory.
+It will be located in the "tgis" sub-directory to not
+interfere with the sqlite3 database used for vector attribute storage.
+<p>
+In case you have tens of thousands of maps to register in the
temporal database or you need concurrent read and write access in the
-TGIS database, consider to use a postgresql database instead.
+temporal database, consider to use a postgresql connection instead.
+<p>
+Be aware that you have to set the postgresql connection explicitly in every mapset that should store
+temporal information in the temporal database.
+<p>
+Postgresql and sqlite3 databases can not be mixed in a location.
<h3>SQLite</h3>
@@ -49,6 +54,6 @@
<h2>AUTHOR</h2>
-Soeren Gebbert, vTI/AK Braunschweig
+Soeren Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.create/t.create.html
===================================================================
--- grass/trunk/temporal/t.create/t.create.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.create/t.create.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -48,35 +48,37 @@
+-------------------- Space Time Raster Dataset -----------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily at test
+ | Id: ........................ precipitation_daily at soeren
| Name: ...................... precipitation_daily
- | Mapset: .................... test
+ | Mapset: .................... soeren
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 12:18:52.848223
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 15:18:42.710663
+ | Modification time:.......... 2014-11-23 15:18:48.868022
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-27 00:00:00
- | End time:................... 2012-09-03 00:00:00
+ | Start time:................. 2012-08-20 00:00:00
+ | End time:................... 2012-08-27 00:00:00
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
- | South:...................... -1.0
- | East:.. .................... 120.5
- | West:....................... -40.5
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_test_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_da8e16e0bdeb4bd3a0970a0980f11468
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 0.0
| Minimum value max:.......... 0.0
| Maximum value min:.......... 9.0
| Maximum value max:.......... 9.0
+ | Aggregation type:........... None
| Number of registered maps:.. 7
|
| Title:
@@ -84,15 +86,16 @@
| Description:
| Test dataset with daily precipitation
| Command history:
- | # 2013-07-13 12:18:52
+ | # 2014-11-23 15:18:42
| t.create type="strds" temporaltype="absolute"
| output="precipitation_daily" title="Daily precipitation"
| description="Test dataset with daily precipitation"
- | # 2013-07-13 12:18:53
+ | # 2014-11-23 15:18:48
| t.register -i type="rast" input="precipitation_daily"
| file="map_list.txt" start="2012-08-20" increment="1 days"
|
+----------------------------------------------------------------------------+
+
</pre></div>
<h2>SEE ALSO</h2>
@@ -104,7 +107,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.info/t.info.html
===================================================================
--- grass/trunk/temporal/t.info/t.info.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.info/t.info.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -32,10 +32,14 @@
t.info -s
+------------------- Temporal DBMI backend information ----------------------+
| DBMI Python interface:...... sqlite3
- | DBMI init string:........... /home/soeren/grassdata/Test_ECAD_3/PERMANENT/tgis/sqlite.db
- | SQL template path:.......... /home/soeren/src/grass7.0/grass_trunk/dist.x86_64-unknown-linux-gnu/etc/sql
+ | Temporal database string:... /home/soeren/grassdata/LL/soeren/tgis/sqlite.db
+ | SQL template path:.......... /home/soeren/src/grass7.1/grass_trunk/dist.x86_64-unknown-linux-gnu/etc/sql
+ | tgis_db_version .......... 2
+ | creation_time .......... 2014-11-22 20:06:46.863733
+ | tgis_version .......... 2
+----------------------------------------------------------------------------+
+
r.mapcalc expr="map1 = rand(0, 10)" -s
t.create type=strds temporaltype=absolute \
@@ -51,12 +55,12 @@
+-------------------- Raster Dataset ----------------------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ map1 at PERMANENT
+ | Id: ........................ map1 at soeren
| Name: ...................... map1
- | Mapset: .................... PERMANENT
+ | Mapset: .................... soeren
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 11:38:19.357300
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 15:20:28.034464
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
| End time:................... 2012-08-21 00:00:00
@@ -76,21 +80,22 @@
| East-west resolution:....... 10.0
| Minimum value:.............. 0.0
| Maximum value:.............. 9.0
- | STRDS register table ....... map_2db89689ae774e9f929ef693339ae116_strds_register
- | Registered datasets ........ precipitation_daily at PERMANENT
+ | Registered datasets ........ precipitation_daily at soeren
+----------------------------------------------------------------------------+
+
t.info type=strds input=precipitation_daily
+-------------------- Space Time Raster Dataset -----------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily at test
+ | Id: ........................ precipitation_daily at soeren
| Name: ...................... precipitation_daily
- | Mapset: .................... test
+ | Mapset: .................... soeren
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 12:16:26.971963
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 15:20:27.587727
+ | Modification time:.......... 2014-11-23 15:20:28.054839
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
@@ -99,21 +104,22 @@
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
- | South:...................... -1.0
- | East:.. .................... 120.5
- | West:....................... -40.5
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_test_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_068a3f307c774379805285e33bbaa6d8
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 0.0
| Minimum value max:.......... 0.0
| Maximum value min:.......... 9.0
| Maximum value max:.......... 9.0
+ | Aggregation type:........... None
| Number of registered maps:.. 1
|
| Title:
@@ -121,15 +127,17 @@
| Description:
| Test dataset with daily precipitation
| Command history:
- | # 2013-07-13 12:16:27
+ | # 2014-11-23 15:20:27
| t.create type="strds" temporaltype="absolute"
| output="precipitation_daily" title="Daily precipitation"
| description="Test dataset with daily precipitation"
- | # 2013-07-13 12:16:27
+ | # 2014-11-23 15:20:28
| t.register -i type="rast" input="precipitation_daily"
| maps="map1" start="2012-08-20" increment="1 days"
|
+----------------------------------------------------------------------------+
+
+
</pre></div>
<h2>SEE ALSO</h2>
@@ -144,7 +152,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.list/t.list.html
===================================================================
--- grass/trunk/temporal/t.list/t.list.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.list/t.list.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -11,10 +11,15 @@
order of the datasets. In addition a SQL WHERE statement can be
specified to select a subset of the requested datasets.
+<h2>NOTE</h2>
+
+The SQL where and sort expression will be applied for each temporal database that was found in
+accessible mapsets. Hence sorting works only on mapset basis.
+
<h2>EXAMPLE</h2>
-In this example we will create three raster maps and register them first
-only in the temporal database an then in the newly created space time
+In this example we will create three raster maps and register them
+in the temporal database an then in the newly created space time
raster dataset. We use <em>t.list</em> to show what maps are already
in the temporal database:
@@ -57,7 +62,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.merge/t.merge.html
===================================================================
--- grass/trunk/temporal/t.merge/t.merge.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.merge/t.merge.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -40,8 +40,9 @@
| Name: ...................... precipitation_daily_1
| Mapset: .................... soeren
| Creator: ................... soeren
- | Creation time: ............. 2013-07-15 16:05:36.198668
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 15:26:57.395355
+ | Modification time:.......... 2014-11-23 15:26:57.860513
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
@@ -49,22 +50,23 @@
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
- | North:...................... 90.0
- | South:...................... -90.0
- | East:.. .................... 180.0
- | West:....................... -180.0
+ | North:...................... 80.0
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_1_soeren_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_6e6efe25ee9b40e39eb31421d737439b
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 0.0
| Minimum value max:.......... 10.0
| Maximum value min:.......... 9.0
| Maximum value max:.......... 19.0
+ | Aggregation type:........... None
| Number of registered maps:.. 2
|
| Title:
@@ -72,17 +74,18 @@
| Description:
| Test dataset with daily precipitation
| Command history:
- | # 2013-07-15 16:05:36
+ | # 2014-11-23 15:26:57
| t.create type="strds" temporaltype="absolute"
| output="precipitation_daily_1" title="Daily precipitation"
| description="Test dataset with daily precipitation"
- | # 2013-07-15 16:05:36
+ | # 2014-11-23 15:26:57
| t.register -i type="rast"
| input="precipitation_daily_1" maps="map1,map2" start="2012-08-20"
| increment="1 days"
|
+----------------------------------------------------------------------------+
+
r.mapcalc expr="map3 = rand(20, 30)" -s
r.mapcalc expr="map4 = rand(30, 40)" -s
@@ -103,8 +106,9 @@
| Name: ...................... precipitation_daily_2
| Mapset: .................... soeren
| Creator: ................... soeren
- | Creation time: ............. 2013-07-15 16:05:37.430380
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 15:27:20.165074
+ | Modification time:.......... 2014-11-23 15:27:20.613543
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-22 00:00:00
@@ -112,22 +116,23 @@
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
- | North:...................... 90.0
- | South:...................... -90.0
- | East:.. .................... 180.0
- | West:....................... -180.0
+ | North:...................... 80.0
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_2_soeren_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_04eaede279b2476a80c2683254232f84
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 20.0
| Minimum value max:.......... 30.0
| Maximum value min:.......... 29.0
| Maximum value max:.......... 39.0
+ | Aggregation type:........... None
| Number of registered maps:.. 2
|
| Title:
@@ -135,17 +140,18 @@
| Description:
| Test dataset with daily precipitation
| Command history:
- | # 2013-07-15 16:05:37
+ | # 2014-11-23 15:27:20
| t.create type="strds" temporaltype="absolute"
| output="precipitation_daily_2" title="Daily precipitation"
| description="Test dataset with daily precipitation"
- | # 2013-07-15 16:05:37
+ | # 2014-11-23 15:27:20
| t.register -i type="rast"
| input="precipitation_daily_2" maps="map3,map4" start="2012-08-22"
| increment="1 days"
|
+----------------------------------------------------------------------------+
+
t.merge input=precipitation_daily_1,precipitation_daily_2 \
output=precipitation_daily_3
@@ -158,8 +164,9 @@
| Name: ...................... precipitation_daily_3
| Mapset: .................... soeren
| Creator: ................... soeren
- | Creation time: ............. 2013-07-15 16:07:47.292784
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 15:27:44.069272
+ | Modification time:.......... 2014-11-23 15:27:44.088930
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
@@ -167,22 +174,23 @@
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
- | North:...................... 90.0
- | South:...................... -90.0
- | East:.. .................... 180.0
- | West:....................... -180.0
+ | North:...................... 80.0
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_3_soeren_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_33715c8c849a43fbb9bce02e1f28ff5a
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 0.0
| Minimum value max:.......... 30.0
| Maximum value min:.......... 9.0
| Maximum value max:.......... 39.0
+ | Aggregation type:........... None
| Number of registered maps:.. 4
|
| Title:
@@ -190,13 +198,14 @@
| Description:
| Merged space time dataset
| Command history:
- | # 2013-07-15 16:07:47
+ | # 2014-11-23 15:27:44
| t.merge
| input="precipitation_daily_1,precipitation_daily_2"
| output="precipitation_daily_3"
|
+----------------------------------------------------------------------------+
+
</pre></div>
<h2>SEE ALSO</h2>
@@ -209,7 +218,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.accdetect/t.rast.accdetect.html
===================================================================
--- grass/trunk/temporal/t.rast.accdetect/t.rast.accdetect.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.accdetect/t.rast.accdetect.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -78,6 +78,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
+
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.accumulate/t.rast.accumulate.html
===================================================================
--- grass/trunk/temporal/t.rast.accumulate/t.rast.accumulate.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.accumulate/t.rast.accumulate.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -290,6 +290,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
+
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html
===================================================================
--- grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -136,7 +136,7 @@
t.rast.aggregate input=precipitation_daily \
output=precipitation_weekly \
- base=prec_weekly granularity="1 weeks" \
+ base=prec_weekly granularity="1 week" \
method=sum sampling=contains
t.support input=precipitation_weekly \
@@ -188,7 +188,7 @@
| Command history:
| # 2014-08-25 11:33:25
| t.rast.aggregate input="precipitation_daily"
- | output="precipitation_weekly" base="prec_weekly" granularity="1 weeks"
+ | output="precipitation_weekly" base="prec_weekly" granularity="1 week"
| method="sum" sampling="contains"
| # 2014-08-25 11:33:31
| t.support input="precipitation_weekly"
@@ -212,6 +212,6 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.aggregate.ds/t.rast.aggregate.ds.html
===================================================================
--- grass/trunk/temporal/t.rast.aggregate.ds/t.rast.aggregate.ds.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.aggregate.ds/t.rast.aggregate.ds.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -7,6 +7,11 @@
STRDS, STR3DS or STVDS) are used to aggregate the maps of the input
space time raster dataset.
+<h2>NOTE</h2>
+The sampling method must be specified from the sampler dataset point of view.
+It defines the temporal relations hips between intervals of the sampling
+dataset and the input space time raster dataset.
+
<h2>EXAMPLE</h2>
In this example we create 7 raster maps that will be registered in a
@@ -25,7 +30,8 @@
<em>sum</em> to accumulate the precipitation values of all intervals in
the space time vector dataset. The sampling option assures that only
raster maps that are temporally during the time intervals of the space
-time vector dataset are considered for computation:
+time vector dataset are considered for computation. Hence the option is set
+to contains (time stamped vector map layers temporally <b>contain</b> the raster map layers):
<div class="code"><pre>
MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
@@ -48,35 +54,37 @@
+-------------------- Space Time Raster Dataset -----------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily at test
+ | Id: ........................ precipitation_daily at PERMANENT
| Name: ...................... precipitation_daily
- | Mapset: .................... test
+ | Mapset: .................... PERMANENT
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 14:08:32.607419
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 16:48:17.686979
+ | Modification time:.......... 2014-11-23 16:48:18.302978
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-20 00:00:00
- | End time:................... 2012-08-27 00:00:00
+ | Start time:................. 2012-09-10 00:00:00
+ | End time:................... 2012-09-17 00:00:00
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
- | South:...................... -1.0
- | East:.. .................... 120.5
- | West:....................... -40.5
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_test_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_3225725979b14b5db343a00835b882c7
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 1.0
| Minimum value max:.......... 1.0
| Maximum value min:.......... 1.0
| Maximum value max:.......... 1.0
+ | Aggregation type:........... None
| Number of registered maps:.. 7
|
| Title:
@@ -84,16 +92,17 @@
| Description:
| Test dataset with daily precipitation
| Command history:
- | # 2013-07-13 14:08:32
+ | # 2014-11-23 16:48:17
| t.create type="strds" temporaltype="absolute"
| output="precipitation_daily" title="Daily precipitation"
| description="Test dataset with daily precipitation"
- | # 2013-07-13 14:08:33
+ | # 2014-11-23 16:48:18
| t.register -i type="rast" input="precipitation_daily"
| file="map_list.txt" start="2012-08-20" increment="1 days"
|
+----------------------------------------------------------------------------+
+
v.random output=points_1 n=20
v.random output=points_2 n=20
@@ -112,12 +121,13 @@
+-------------------- Space Time Vector Dataset -----------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ points at test
+ | Id: ........................ points at PERMANENT
| Name: ...................... points
- | Mapset: .................... test
+ | Mapset: .................... PERMANENT
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 14:09:03.024090
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 16:48:49.193903
+ | Modification time:.......... 2014-11-23 16:48:50.185671
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
@@ -125,14 +135,14 @@
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
- | North:...................... 73.65504
- | South:...................... 4.601117
- | East:.. .................... 118.150138
- | West:....................... -39.987854
+ | North:...................... 79.283411
+ | South:...................... 5.724954
+ | East:.. .................... 118.881168
+ | West:....................... 0.016755
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Vector register table:...... points_test_vector_register
+ | Vector register table:...... vector_map_register_6f02d33e0ee243d1a521aaaca39ecb31
| Number of points ........... 40
| Number of lines ............ 0
| Number of boundaries ....... 0
@@ -152,13 +162,13 @@
| Description:
| Points for aggregation
| Command history:
- | # 2013-07-13 14:09:03
+ | # 2014-11-23 16:48:49
| t.create type="stvds" temporaltype="absolute"
| output="points" title="Points" description="Points for aggregation"
- | # 2013-07-13 14:09:12
+ | # 2014-11-23 16:48:49
| t.register -i type="vect" input="points"
| map="points_1" start="2012-08-20" increment="3 days"
- | # 2013-07-13 14:09:13
+ | # 2014-11-23 16:48:50
| t.register -i type="vect" input="points"
| map="points_2" start="2012-08-23" increment="4 days"
|
@@ -168,7 +178,7 @@
output=precipitation_agg \
sample=points type=stvds \
base=prec_agg \
- method=sum sampling=during
+ method=sum sampling=contains
t.support input=precipitation_agg \
title="Aggregated precipitation" \
@@ -179,12 +189,13 @@
+-------------------- Space Time Raster Dataset -----------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_agg at test
+ | Id: ........................ precipitation_agg at PERMANENT
| Name: ...................... precipitation_agg
- | Mapset: .................... test
+ | Mapset: .................... PERMANENT
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 14:12:02.489102
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 16:53:23.488799
+ | Modification time:.......... 2014-11-23 16:53:28.714886
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
@@ -193,21 +204,22 @@
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
- | South:...................... -1.0
- | East:.. .................... 120.5
- | West:....................... -40.5
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_agg_test_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_7b025eb7431747c98c5c1ad971e8c282
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
| Minimum value min:.......... 3.0
| Minimum value max:.......... 4.0
| Maximum value min:.......... 3.0
| Maximum value max:.......... 4.0
+ | Aggregation type:........... sum
| Number of registered maps:.. 2
|
| Title:
@@ -215,16 +227,17 @@
| Description:
| Aggregated precipitation dataset
| Command history:
- | # 2013-07-13 14:12:02
+ | # 2014-11-23 16:53:23
| t.rast.aggregate.ds input="precipitation_daily"
| output="precipitation_agg" sample="points" type="stvds" base="prec_agg"
- | method="sum" sampling="during"
- | # 2013-07-13 14:12:09
+ | method="sum" sampling="contains"
+ | # 2014-11-23 16:53:28
| t.support input="precipitation_agg"
| title="Aggregated precipitation"
| description="Aggregated precipitation dataset"
|
+----------------------------------------------------------------------------+
+
</pre></div>
<h2>SEE ALSO</h2>
Modified: grass/trunk/temporal/t.rast.algebra/t.rast.algebra.html
===================================================================
--- grass/trunk/temporal/t.rast.algebra/t.rast.algebra.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.algebra/t.rast.algebra.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -471,7 +471,7 @@
<h2>AUTHOR</h2>
-Thomas Leppelt, Soeren Gebbert, Thuenen Institut, Germany <br>
+Thomas Leppelt, Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.colors/t.rast.colors.html
===================================================================
--- grass/trunk/temporal/t.rast.colors/t.rast.colors.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.colors/t.rast.colors.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -24,14 +24,14 @@
<div class="code"><pre>
g.region s=0 n=80 w=0 e=120 b=0 t=50 res=10 res3=10 -p3
-r.mapcalc --o expr="prec_1 = 100"
-r.mapcalc --o expr="prec_2 = 200"
-r.mapcalc --o expr="prec_3 = 300"
-r.mapcalc --o expr="prec_4 = 400"
-r.mapcalc --o expr="prec_5 = 500"
-r.mapcalc --o expr="prec_6 = 600"
+r.mapcalc expr="prec_1 = 100"
+r.mapcalc expr="prec_2 = 200"
+r.mapcalc expr="prec_3 = 300"
+r.mapcalc expr="prec_4 = 400"
+r.mapcalc expr="prec_5 = 500"
+r.mapcalc expr="prec_6 = 600"
-t.create --o type=strds temporaltype=absolute \
+t.create type=strds temporaltype=absolute \
output=precip_abs title="Color setting example" \
descr="Color setting example"
@@ -66,7 +66,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.export/t.rast.export.html
===================================================================
--- grass/trunk/temporal/t.rast.export/t.rast.export.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.export/t.rast.export.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -3,9 +3,9 @@
This module exports a space time raster dataset as a tar archive. The
archive contains the raster maps either as geotiff files or as GRASS
binary files exported using r.out.bin. The map specific color tables
-are exported as well in case of geotiff files. In addition several meta
+are exported in case of geotiff files. In addition several meta
data files are created in the archive that describe the temporal
-layout. All time stamps are stored in the file "list.txt", for each map
+layout. All time stamps are stored in the file "list.txt". For each map
one row. The name of the map, the start time and the end time are
written. In case of a time instance, the start time is equal to the end
time. The "init.txt" files stores the temporal type, the number of
@@ -123,7 +123,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.extract/t.rast.extract.html
===================================================================
--- grass/trunk/temporal/t.rast.extract/t.rast.extract.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.extract/t.rast.extract.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -86,7 +86,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.gapfill/t.rast.gapfill.html
===================================================================
--- grass/trunk/temporal/t.rast.gapfill/t.rast.gapfill.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.gapfill/t.rast.gapfill.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -34,33 +34,35 @@
t.register type=rast input=precipitation_daily maps=map1,map2,map3
-t.rast.list -h input=precipitation_daily columns=name,start_time,min,max
+t.rast.list input=precipitation_daily columns=name,start_time,min,max
-name start_time min max
-map1 2012-08-20 00:00:00 1.0 1.0
-map2 2012-08-22 00:00:00 3.0 3.0
-map3 2012-08-24 00:00:00 5.0 5.0
+name|start_time|min|max
+map1|2012-08-20 00:00:00|1.0|1.0
+map2|2012-08-22 00:00:00|3.0|3.0
+map3|2012-08-24 00:00:00|5.0|5.0
-t.rast.list -h input=precipitation_daily method=deltagaps
-id name mapset start_time end_time interval_length distance_from_begin
-map1 at soeren map1 soeren 2012-08-20 00:00:00 2012-08-21 00:00:00 1.0 0.0
-None None None 2012-08-21 00:00:00 2012-08-22 00:00:00 1.0 1.0
-map2 at soeren map2 soeren 2012-08-22 00:00:00 2012-08-23 00:00:00 1.0 2.0
-None None None 2012-08-23 00:00:00 2012-08-24 00:00:00 1.0 3.0
-map3 at soeren map3 soeren 2012-08-24 00:00:00 2012-08-25 00:00:00 1.0 4.0
+t.rast.list input=precipitation_daily method=deltagaps
+id|name|mapset|start_time|end_time|interval_length|distance_from_begin
+map1 at PERMANENT|map1|PERMANENT|2012-08-20 00:00:00|2012-08-21 00:00:00|1.0|0.0
+None|None|None|2012-08-21 00:00:00|2012-08-22 00:00:00|1.0|1.0
+map2 at PERMANENT|map2|PERMANENT|2012-08-22 00:00:00|2012-08-23 00:00:00|1.0|2.0
+None|None|None|2012-08-23 00:00:00|2012-08-24 00:00:00|1.0|3.0
+map3 at PERMANENT|map3|PERMANENT|2012-08-24 00:00:00|2012-08-25 00:00:00|1.0|4.0
+
t.rast.gapfill input=precipitation_daily base=gap
-t.rast.list -h input=precipitation_daily columns=name,start_time,min,max
+t.rast.list input=precipitation_daily columns=name,start_time,min,max
-name start_time min max
-map1 2012-08-20 00:00:00 1.0 1.0
-gap_6 2012-08-21 00:00:00 2.0 2.0
-map2 2012-08-22 00:00:00 3.0 3.0
-gap_7 2012-08-23 00:00:00 4.0 4.0
-map3 2012-08-24 00:00:00 5.0 5.0
+name|start_time|min|max
+map1|2012-08-20 00:00:00|1.0|1.0
+gap_6|2012-08-21 00:00:00|2.0|2.0
+map2|2012-08-22 00:00:00|3.0|3.0
+gap_7|2012-08-23 00:00:00|4.0|4.0
+map3|2012-08-24 00:00:00|5.0|5.0
+
</pre></div>
<h2>SEE ALSO</h2>
@@ -73,7 +75,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.import/t.rast.import.html
===================================================================
--- grass/trunk/temporal/t.rast.import/t.rast.import.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.import/t.rast.import.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -32,13 +32,14 @@
t.rast.list precipitation_daily
-map_1 soeren 2012-09-03 00:00:00 2012-09-04 00:00:00
-map_2 soeren 2012-09-04 00:00:00 2012-09-05 00:00:00
-map_3 soeren 2012-09-05 00:00:00 2012-09-06 00:00:00
-map_4 soeren 2012-09-06 00:00:00 2012-09-07 00:00:00
-map_5 soeren 2012-09-07 00:00:00 2012-09-08 00:00:00
-map_6 soeren 2012-09-08 00:00:00 2012-09-09 00:00:00
-map_7 soeren 2012-09-09 00:00:00 2012-09-10 00:00:00
+name|mapset|start_time|end_time
+map_1|PERMANENT|2012-08-20 00:00:00|2012-08-21 00:00:00
+map_2|PERMANENT|2012-08-21 00:00:00|2012-08-22 00:00:00
+map_3|PERMANENT|2012-08-22 00:00:00|2012-08-23 00:00:00
+map_4|PERMANENT|2012-08-23 00:00:00|2012-08-24 00:00:00
+map_5|PERMANENT|2012-08-24 00:00:00|2012-08-25 00:00:00
+map_6|PERMANENT|2012-08-25 00:00:00|2012-08-26 00:00:00
+map_7|PERMANENT|2012-08-26 00:00:00|2012-08-27 00:00:00
t.rast.export input=precipitation_daily output=precipitation_daily.tar.gz \
compression=gzip
@@ -47,13 +48,15 @@
t.rast.list new_precipitation_daily
-new_map_1 soeren 2012-09-03 00:00:00 2012-09-04 00:00:00
-new_map_2 soeren 2012-09-04 00:00:00 2012-09-05 00:00:00
-new_map_3 soeren 2012-09-05 00:00:00 2012-09-06 00:00:00
-new_map_4 soeren 2012-09-06 00:00:00 2012-09-07 00:00:00
-new_map_5 soeren 2012-09-07 00:00:00 2012-09-08 00:00:00
-new_map_6 soeren 2012-09-08 00:00:00 2012-09-09 00:00:00
-new_map_7 soeren 2012-09-09 00:00:00 2012-09-10 00:00:00
+name|mapset|start_time|end_time
+new_map_1|PERMANENT|2012-08-20 00:00:00|2012-08-21 00:00:00
+new_map_2|PERMANENT|2012-08-21 00:00:00|2012-08-22 00:00:00
+new_map_3|PERMANENT|2012-08-22 00:00:00|2012-08-23 00:00:00
+new_map_4|PERMANENT|2012-08-23 00:00:00|2012-08-24 00:00:00
+new_map_5|PERMANENT|2012-08-24 00:00:00|2012-08-25 00:00:00
+new_map_6|PERMANENT|2012-08-25 00:00:00|2012-08-26 00:00:00
+new_map_7|PERMANENT|2012-08-26 00:00:00|2012-08-27 00:00:00
+
</pre></div>
<h2>SEE ALSO</h2>
@@ -66,7 +69,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.list/t.rast.list.html
===================================================================
--- grass/trunk/temporal/t.rast.list/t.rast.list.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.list/t.rast.list.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -59,6 +59,7 @@
map_1 at PERMANENT,map_2 at PERMANENT,map_3 at PERMANENT,map_4 at PERMANENT,map_5 at PERMANENT,map_6 at PERMANENT
t.rast.list method=col input=test_strds
+name|mapset|start_time|end_time
map_1|PERMANENT|2001-01-01 00:00:00|2001-04-01 00:00:00
map_2|PERMANENT|2001-05-01 00:00:00|2001-07-01 00:00:00
map_3|PERMANENT|2001-08-01 00:00:00|2001-10-01 00:00:00
@@ -185,7 +186,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.mapcalc/t.rast.mapcalc.html
===================================================================
--- grass/trunk/temporal/t.rast.mapcalc/t.rast.mapcalc.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.mapcalc/t.rast.mapcalc.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -166,7 +166,66 @@
t.info type=strds input=C
-t.rast.list -h input=C columns=name,start_time,min,max
+ +-------------------- Space Time Raster Dataset -----------------------------+
+ | |
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ C at PERMANENT
+ | Name: ...................... C
+ | Mapset: .................... PERMANENT
+ | Creator: ................... soeren
+ | Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 17:06:53.273538
+ | Modification time:.......... 2014-11-23 17:06:53.326765
+ | Semantic type:.............. mean
+ +-------------------- Absolute time -----------------------------------------+
+ | Start time:................. 2001-03-01 00:00:00
+ | End time:................... 2001-09-01 00:00:00
+ | Granularity:................ 1 month
+ | Temporal type of maps:...... interval
+ +-------------------- Spatial extent ----------------------------------------+
+ | North:...................... 80.0
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
+ | Top:........................ 0.0
+ | Bottom:..................... 0.0
+ +-------------------- Metadata information ----------------------------------+
+ | Raster register table:...... raster_map_register_155fc9f08e01417da73f341feaaf5ea0
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
+ | Minimum value min:.......... 9.0
+ | Minimum value max:.......... 64.0
+ | Maximum value min:.......... 9.0
+ | Maximum value max:.......... 64.0
+ | Aggregation type:........... None
+ | Number of registered maps:.. 6
+ |
+ | Title:
+ | Dataset A
+ | Description:
+ | Dataset A
+ | Command history:
+ | # 2014-11-23 17:06:53
+ | t.rast.mapcalc input="A,B" output="C" base="c"
+ | method="equal"
+ | expr="if(start_month() == 5 || start_month() == 6, (A + B), (A * B))"
+ |
+ +----------------------------------------------------------------------------+
+
+
+t.rast.list input=C columns=name,start_time,min,max
+
+name|start_time|min|max
+c_1|2001-03-01 00:00:00|9.0|9.0
+c_2|2001-04-01 00:00:00|16.0|16.0
+c_3|2001-05-01 00:00:00|10.0|10.0
+c_4|2001-06-01 00:00:00|12.0|12.0
+c_5|2001-07-01 00:00:00|49.0|49.0
+c_6|2001-08-01 00:00:00|64.0|64.0
+
+
</pre></div>
@@ -181,7 +240,7 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.neighbors/t.rast.neighbors.html
===================================================================
--- grass/trunk/temporal/t.rast.neighbors/t.rast.neighbors.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.neighbors/t.rast.neighbors.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -14,7 +14,7 @@
The user can select a subset of the input space time raster dataset for
processing using a SQL WHERE statement. The number of CPU's to be used
for parallel processing can be specified with the <em>nprocs</em>
-option, to speedup the computation on multicore system.
+option, to speedup the computation on multi-core system.
<h2>EXAMPLE</h2>
@@ -60,13 +60,14 @@
| Name: ...................... precipitation_daily
| Mapset: .................... PERMANENT
| Creator: ................... soeren
- | Creation time: ............. 2013-03-20 18:47:25.867658
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 17:08:11.135848
+ | Modification time:.......... 2014-11-23 17:08:11.647709
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
| End time:................... 2012-08-27 00:00:00
- | Granularity:................ 1 days
+ | Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
@@ -76,11 +77,7 @@
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Number of registered maps:.. 7
- | Title:
- | Daily precipitation
- | Description:
- | Test dataset with daily precipitation
+ | Raster register table:...... raster_map_register_8a6ea51f0d584b1fb2d48747e4d4c41c
| North-South resolution min:. 10.0
| North-South resolution max:. 10.0
| East-west resolution min:... 10.0
@@ -89,19 +86,36 @@
| Minimum value max:.......... 8.0
| Maximum value min:.......... 533.0
| Maximum value max:.......... 549.0
- | Raster register table:...... precipitation_daily_PERMANENT_raster_register
+ | Aggregation type:........... None
+ | Number of registered maps:.. 7
+ |
+ | Title:
+ | Daily precipitation
+ | Description:
+ | Test dataset with daily precipitation
+ | Command history:
+ | # 2014-11-23 17:08:11
+ | t.create --o type="strds" temporaltype="absolute"
+ | output="precipitation_daily" title="Daily precipitation"
+ | description="Test dataset with daily precipitation"
+ | # 2014-11-23 17:08:11
+ | t.register -i --o type="rast"
+ | input="precipitation_daily" file="map_list.txt" start="2012-08-20"
+ | increment="1 days"
+ |
+----------------------------------------------------------------------------+
t.rast.list input=precipitation_daily columns=name,start_time,min,max
-map_1 2012-08-20 00:00:00 2.0 549.0
-map_2 2012-08-21 00:00:00 4.0 549.0
-map_3 2012-08-22 00:00:00 8.0 548.0
-map_4 2012-08-23 00:00:00 3.0 549.0
-map_5 2012-08-24 00:00:00 0.0 533.0
-map_6 2012-08-25 00:00:00 2.0 543.0
-map_7 2012-08-26 00:00:00 1.0 539.0
+name|start_time|min|max
+map_1|2012-08-20 00:00:00|2.0|549.0
+map_2|2012-08-21 00:00:00|4.0|549.0
+map_3|2012-08-22 00:00:00|8.0|548.0
+map_4|2012-08-23 00:00:00|3.0|549.0
+map_5|2012-08-24 00:00:00|0.0|533.0
+map_6|2012-08-25 00:00:00|2.0|543.0
+map_7|2012-08-26 00:00:00|1.0|539.0
t.rast.neighbors --o input=precipitation_daily \
@@ -117,13 +131,14 @@
| Name: ...................... precipitation_daily_smooth
| Mapset: .................... PERMANENT
| Creator: ................... soeren
- | Creation time: ............. 2013-03-20 18:47:28.697990
| Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 17:08:59.430447
+ | Modification time:.......... 2014-11-23 17:08:59.482735
| Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
| Start time:................. 2012-08-20 00:00:00
| End time:................... 2012-08-27 00:00:00
- | Granularity:................ 1 days
+ | Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
@@ -133,32 +148,42 @@
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
+ | Raster register table:...... raster_map_register_0ae9d82363db46a991665a0e51a46743
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
+ | Minimum value min:.......... 139.666667
+ | Minimum value max:.......... 214.666667
+ | Maximum value min:.......... 292.8
+ | Maximum value max:.......... 372.888889
+ | Aggregation type:........... None
| Number of registered maps:.. 7
+ |
| Title:
| Daily precipitation
| Description:
| Test dataset with daily precipitation
- | North-South resolution min:. 10.0
- | North-South resolution max:. 10.0
- | East-west resolution min:... 10.0
- | East-west resolution max:... 10.0
- | Minimum value min:.......... 140.166667
- | Minimum value max:.......... 215.166667
- | Maximum value min:.......... 293.3
- | Maximum value max:.......... 373.388889
- | Raster register table:...... precipitation_daily_smooth_PERMANENT_raster_register
+ | Command history:
+ | # 2014-11-23 17:08:59
+ | t.rast.neighbors --o input="precipitation_daily"
+ | output="precipitation_daily_smooth" base="prec_smooth" size="5"
+ | method="average" nprocs="3"
+ |
+----------------------------------------------------------------------------+
t.rast.list input=precipitation_daily_smooth columns=name,start_time,min,max
-prec_smooth_1 2012-08-20 00:00:00 172.388889 360.566667
-prec_smooth_2 2012-08-21 00:00:00 215.166667 322.833333
-prec_smooth_3 2012-08-22 00:00:00 140.166667 373.388889
-prec_smooth_4 2012-08-23 00:00:00 184.3 356.583333
-prec_smooth_5 2012-08-24 00:00:00 163.966667 293.3
-prec_smooth_6 2012-08-25 00:00:00 204.98 324.611111
-prec_smooth_7 2012-08-26 00:00:00 154.25 340.366667
+name|start_time|min|max
+prec_smooth_1|2012-08-20 00:00:00|171.888889|360.066667
+prec_smooth_2|2012-08-21 00:00:00|214.666667|322.333333
+prec_smooth_3|2012-08-22 00:00:00|139.666667|372.888889
+prec_smooth_4|2012-08-23 00:00:00|183.8|356.083333
+prec_smooth_5|2012-08-24 00:00:00|163.466667|292.8
+prec_smooth_6|2012-08-25 00:00:00|204.48|324.111111
+prec_smooth_7|2012-08-26 00:00:00|153.75|339.866667
+
</pre></div>
<h2>SEE ALSO</h2>
@@ -175,6 +200,6 @@
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.out.vtk/t.rast.out.vtk.html
===================================================================
--- grass/trunk/temporal/t.rast.out.vtk/t.rast.out.vtk.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.out.vtk/t.rast.out.vtk.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -1,25 +1,63 @@
<h2>DESCRIPTION</h2>
-TBD.
+This module exports all maps registered in a space time raster datasets as VTK legacy files
+using a numerical numbering scheme. The VTK files can be visualized with any VTK based
+visualize. Our preferred tool is ParaView. The VTK legacy files are created using <b>r.out.vtk</b>.
<h2>EXAMPLE</h2>
-The example is based on the XXX sample dataset:
+In this simple example we create several raster maps with random values and one elevation map.
+The random value raster maps are registered in a space time raster dataset. All maps of this
+space time raster dataset are exported using <b>t.rast.out.vtk</b> into the directoy <b>/tmp/test1</b>.
+
<div class="code"><pre>
-TBD
+r.mapcalc --o expr="prec_1 = rand(0, 550)" -s
+r.mapcalc --o expr="prec_2 = rand(0, 450)" -s
+r.mapcalc --o expr="prec_3 = rand(0, 320)" -s
+r.mapcalc --o expr="prec_4 = rand(0, 510)" -s
+r.mapcalc --o expr="prec_5 = rand(0, 300)" -s
+r.mapcalc --o expr="prec_6 = rand(0, 650)" -s
+r.mapcalc --o expr="elevation = sin(row() + col()) * 10"
+
+n1=`g.tempfile pid=1 -d`
+
+cat > "${n1}" << EOF
+prec_1|2001-01-01|2001-02-01
+prec_2|2001-02-01|2001-03-01
+prec_3|2001-03-01|2001-04-01
+prec_4|2001-05-01|2001-06-01
+prec_5|2001-07-01|2001-08-01
+prec_6|2001-08-01|2001-09-01
+EOF
+
+t.create --o type=strds temporaltype=absolute output=precip_abs title="A test with input files" descr="A test with input files"
+
+t.register -i type=rast input=precip_abs file="${n1}"
+
+mkdir /tmp/test1
+t.rast.out.vtk input=precip_abs expdir=/tmp/test1 elevation=elevation
+
+ls -al /tmp/test1
+-rw-rw-r-- 1 soeren soeren 1857 Nov 23 15:59 000000_precip_abs.vtk
+-rw-rw-r-- 1 soeren soeren 1849 Nov 23 15:59 000001_precip_abs.vtk
+-rw-rw-r-- 1 soeren soeren 1836 Nov 23 15:59 000002_precip_abs.vtk
+-rw-rw-r-- 1 soeren soeren 1854 Nov 23 15:59 000003_precip_abs.vtk
+-rw-rw-r-- 1 soeren soeren 1842 Nov 23 15:59 000004_precip_abs.vtk
+-rw-rw-r-- 1 soeren soeren 1858 Nov 23 15:59 000005_precip_abs.vtk
+
</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="r.out.vtk.html">r.out.vtk</a>,
+<a href="http://www.paraview.org">ParaView</a>
</em>
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.series/t.rast.series.html
===================================================================
--- grass/trunk/temporal/t.rast.series/t.rast.series.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.series/t.rast.series.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -1,11 +1,20 @@
<h2>DESCRIPTION</h2>
-TBD.
+This module is a simple wrapper for the raster module <b>r.series</b>.
+It supports a subset of the aggregation methods of <b>r.series</b>.
+<p>
+The input of this module is a single space time raster dataset, the output is a single
+raster map layer. A subset of the input space time raster dataset can be selected using the <b>where</b>
+option. The sorting of the raster map layer can be set using the <b>order</b> option.
+Be aware that the order of the maps can significantly influence the result of the aggregation (e.g.: slope).
+By default the maps are ordered by <b>start_time</b>.
+
<h2>EXAMPLE</h2>
-Example for monthly aggregation:
-
+Example for monthly aggregation with complex <b>where</b> statements
+to aggregate a single month in a time series of several years:
+<p>
<div class="code"><pre>
# January averages
t.rast.series input=monthly_aggregates \
@@ -26,13 +35,14 @@
<h2>SEE ALSO</h2>
<em>
+<a href="r.series.html">r.series</a>,
<a href="t.create.html">t.create</a>,
<a href="t.info.html">t.info</a>
</em>
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.series/t.rast.series.py
===================================================================
--- grass/trunk/temporal/t.rast.series/t.rast.series.py 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.series/t.rast.series.py 2014-11-23 16:12:54 UTC (rev 62871)
@@ -41,7 +41,7 @@
#% required: no
#% multiple: yes
#% options: id, name, creator, mapset, creation_time, modification_time, start_time, end_time, north, south, west, east, min, max
-#% answer: id
+#% answer: start_time
#%end
#%option G_OPT_T_WHERE
Modified: grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.html
===================================================================
--- grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.html 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.html 2014-11-23 16:12:54 UTC (rev 62871)
@@ -1,25 +1,203 @@
<h2>DESCRIPTION</h2>
-TBD.
+This module is designed to convert a space time raster dataset (STRDS) into a space time voxel cube.
+A space time voxel cube is a 3 dimensional raster map layer (3d raster map or voxel map layer) that as time as
+unit for the z-dimension.
+<p>
+A space time raster dataset that should be converted into a space time
+voxel cube must have a valid temporal topology. Hence, overlapping or inclusion of time stamps is not allowed.
+The granularity of the STRDS is used to set the resolution of the 3d raster map layer
+and to sample the registered time stamped raster map layers.
+<p>
+Gaps between raster map layer in the STRDS will
+be represented by NULL values in the voxel map layer.
+
+<h2>NOTE</h2>
+
+The reference time for all space time voxel cubes is 1900-01-0100:00:00. This allows the alignment
+space time voxel cubes with different granularities.
+<p>
+Be aware that the granularity of a STRDS is used to sample time stamped map layers! If you have gaps
+between monthly intervals that have the size of a second, the monthly intervals will be sampled by a second based granularity as well. This may result in millions of space time voxel cube layers!
+
<h2>EXAMPLE</h2>
-The example is based on the XXX sample dataset:
+This simple example that converts a space time raster dataset that has gaps between its time stamped
+map layers into a space time voxel cube. The time stamped raster map layer have a interval size of three months.
+However, the granularity is one month, since of each gap has an interval size of one month. The resulting
+voxel map layer has 9 depths. Hence, the space time raster dataset is sampled by its granularity resulting
+in 9 layer.
<div class="code"><pre>
-TBD
+g.region s=0 n=80 w=0 e=120 b=0 t=1 res=10 res3=10 -p3
+
+r.mapcalc --o expr="a1 = 100.0"
+r.mapcalc --o expr="a2 = 200.0"
+r.mapcalc --o expr="a3 = 300.0"
+
+n1=`g.tempfile pid=1 -d`
+
+cat > "${n1}" << EOF
+a1|2001-01-01|2001-04-01
+a2|2001-05-01|2001-07-01
+a3|2001-08-01|2001-10-01
+EOF
+
+t.create type=strds temporaltype=absolute output=A title="A test" descr="A test"
+
+t.register -i type=rast input=A file=${n1}
+
+t.info type=strds input=A
+
+ +-------------------- Space Time Raster Dataset -----------------------------+
+ | |
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ A at PERMANENT
+ | Name: ...................... A
+ | Mapset: .................... PERMANENT
+ | Creator: ................... soeren
+ | Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 16:28:21.170177
+ | Modification time:.......... 2014-11-23 16:28:21.641846
+ | Semantic type:.............. mean
+ +-------------------- Absolute time -----------------------------------------+
+ | Start time:................. 2001-01-01 00:00:00
+ | End time:................... 2001-10-01 00:00:00
+ | Granularity:................ 1 month
+ | Temporal type of maps:...... interval
+ +-------------------- Spatial extent ----------------------------------------+
+ | North:...................... 80.0
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
+ | Top:........................ 0.0
+ | Bottom:..................... 0.0
+ +-------------------- Metadata information ----------------------------------+
+ | Raster register table:...... raster_map_register_c70e476695a04975a03ccb655ed0bb2c
+ | North-South resolution min:. 10.0
+ | North-South resolution max:. 10.0
+ | East-west resolution min:... 10.0
+ | East-west resolution max:... 10.0
+ | Minimum value min:.......... 100.0
+ | Minimum value max:.......... 300.0
+ | Maximum value min:.......... 100.0
+ | Maximum value max:.......... 300.0
+ | Aggregation type:........... None
+ | Number of registered maps:.. 3
+ |
+ | Title:
+ | A test
+ | Description:
+ | A test
+ | Command history:
+ | # 2014-11-23 16:28:21
+ | t.create type="strds" temporaltype="absolute"
+ | output="A" title="A test" descr="A test"
+ | # 2014-11-23 16:28:21
+ | t.register -i type="rast" input="A"
+ | file="/home/soeren/grassdata/LL/PERMANENT/.tmp/knecht/1.2"
+ |
+ +----------------------------------------------------------------------------+
+
+
+t.rast.to.rast3 input=A output=cube
+
+t.info type=rast3d input=cube
+
+ +-------------------- 3D Raster Dataset -------------------------------------+
+ | |
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ cube at PERMANENT
+ | Name: ...................... cube
+ | Mapset: .................... PERMANENT
+ | Creator: ................... soeren
+ | Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-23 16:28:46.341227
+ +-------------------- Absolute time -----------------------------------------+
+ | Start time:................. 2001-01-01 00:00:00
+ | End time:................... 2001-10-01 00:00:00
+ +-------------------- Spatial extent ----------------------------------------+
+ | North:...................... 80.0
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
+ | Top:........................ 1222.0
+ | Bottom:..................... 1213.0
+ +-------------------- Metadata information ----------------------------------+
+ | Datatype:................... DCELL
+ | Number of columns:.......... 8
+ | Number of rows:............. 12
+ | Number of cells:............ 864
+ | North-South resolution:..... 10.0
+ | East-west resolution:....... 10.0
+ | Minimum value:.............. 100.0
+ | Maximum value:.............. 300.0
+ | Number of depths:........... 9
+ | Top-Bottom resolution:...... 1.0
+ | Registered datasets ........
+ +----------------------------------------------------------------------------+
+
+
+r3.info cube
+
+ +----------------------------------------------------------------------------+
+ | Layer: cube Date: Sun Nov 23 16:28:46 2014 |
+ | Mapset: PERMANENT Login of Creator: soeren |
+ | Location: LL |
+ | DataBase: /home/soeren/grassdata |
+ | Title: Space time voxel cube |
+ | Units: none |
+ | Vertical unit: months |
+ | Timestamp: 1 Jan 2001 00:00:00 / 1 Oct 2001 00:00:00 |
+ |----------------------------------------------------------------------------|
+ | |
+ | Type of Map: 3d cell Number of Categories: 0 |
+ | Data Type: DCELL |
+ | Rows: 8 |
+ | Columns: 12 |
+ | Depths: 9 |
+ | Total Cells: 864 |
+ | Total size: 116 Bytes |
+ | Number of tiles: 1 |
+ | Mean tile size: 116 Bytes |
+ | Tile size in memory: 6912 Bytes |
+ | Number of tiles in x, y and z: 1, 1, 1 |
+ | Dimension of a tile in x, y, z: 12, 8, 9 |
+ | |
+ | Projection: Latitude-Longitude (zone 0) |
+ | N: 80N S: 0 Res: 10 |
+ | E: 120E W: 0 Res: 10 |
+ | T: 1222 B: 1213 Res: 1 |
+ | Range of data: min = 100 max = 300 |
+ | |
+ | Data Source: |
+ | |
+ | |
+ | |
+ | Data Description: |
+ | This space time voxel cube was created with t.rast.to.rast3 |
+ | |
+ | Comments: |
+ | r.to.rast3 input="a1 at PERMANENT,a1 at PERMANENT,a1 at PERMANENT,temporary_n\ |
+ | ull_map_22842,a2 at PERMANENT,a2 at PERMANENT,temporary_null_map_22842,a3@\ |
+ | PERMANENT,a3 at PERMANENT" output="cube" tilesize=32 |
+ | |
+ +----------------------------------------------------------------------------+
+
+
</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="r3.mapcalc.html">r3.mapcalc</a>,
+<a href="r3.info.html">r3.info</a>
</em>
<h2>AUTHOR</h2>
-Sören Gebbert
+Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
<p><i>Last changed: $Date$</i>
Modified: grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.py
===================================================================
--- grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.py 2014-11-23 16:11:25 UTC (rev 62870)
+++ grass/trunk/temporal/t.rast.to.rast3/t.rast.to.rast3.py 2014-11-23 16:12:54 UTC (rev 62871)
@@ -5,7 +5,7 @@
# MODULE: t.rast.to.rast3
# AUTHOR(S): Soeren Gebbert
#
-# PURPOSE: Convert a space time raster dataset into a rast3d map
+# PURPOSE: Convert a space time raster dataset into a 3d raster map
# COPYRIGHT: (C) 2011 by the GRASS Development Team
#
# This program is free software under the GNU General Public
@@ -15,7 +15,7 @@
#############################################################################
#%module
-#% description: Converts a space time raster dataset into a raster3d map.
+#% description: Converts a space time raster dataset into a 3d raster map.
#% keywords: temporal
#% keywords: conversion
#% keywords: raster3d
More information about the grass-commit
mailing list