documentation: update several space time docs with the coming NC temporal dataset

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@63363 15284696-431f-4ddb-bdfa-cd5b030d7da7

temporal/t.connect/t.connect.html

@@ -1,39 +1,41 @@
 <h2>DESCRIPTION</h2>
 
 <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.
+The default setting is that the temporal database of
+type <em>sqlite3</em> is located in the current mapset directory.
 
 <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 temporal database connection 
-parameters have been set, and if not will set them to use GRASS's 
+using shell style.
+<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>
+<h2>NOTE</h2>
 
-Setting the connection with t.connect will not test the connection for validity. 
+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 
+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. 
+A SQLite 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.
+interfere with the <em>sqlite3<em> 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 
-temporal database, consider to use a postgresql connection instead.
+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
+temporal database, consider to use a PostgreSQL connection instead.
 <p>
-Be aware that you have to set the postgresql connection explicitly in
+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.
+PostgreSQL and SQLite databases can not be mixed in a location.
 
-<h3>SQLite</h3>
+<h2>EXAMPLES</h2>
 
+<h3>SQLite</h3>
+The SQLite database is created automatically when used the first time.
 <div class="code"><pre>
 t.connect driver=sqlite database='$GISDBASE/$LOCATION_NAME/PERMANENT/tgis/sqlite.db'
 t.connect -p
@@ -41,11 +43,12 @@ t.info -s
 </pre></div>
 
 <p>
-The SQLite database is created automatically when used the first time.
 
 <h3>PostgreSQL</h3>
-In case you use a PostgreSQL database, you will need to specify the TGIS database connection 
-for each mapset.
+
+When using a PostgreSQL database, the user will need to specify the TGIS
+database connection for each mapset.
+
 <div class="code"><pre>
 t.connect driver=pg database="dbname=grass_test user=soeren password=abcdefgh"
 t.connect -p

temporal/t.create/t.create.html

@@ -1,100 +1,43 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.create</em> is used to create space time datasets of 
+<em>t.create</em> is used to create space time datasets of
 type raster (STRDS), 3D raster (STR3DS) and vector (STVDS).
 <p>
-Space time datasets represent spatio-temporal fields in the temporal 
-GRASS framework. They are designed to collect any amount of time 
-stamped maps with time intervals and time instances. The temporal type 
-of a space time dataset can be absolute or relative and must be set on 
-dataset creation besides the name and the description.
+Space time datasets represent spatio-temporal fields in the temporal
+GRASS framework. They are designed to collect any amount of time
+stamped maps with time intervals and time instances. The temporal
+type of a space time dataset can be absolute (means with a fixed date)
+or relative (only sequential maps) and must be set during
+dataset creation along with the name and the description.
 <p>
-Time stamped maps can registered in and unregistered from space time 
-datasets. The spatio-temporal extent as well as the metadata of a space 
-time dataset is derived from its registered maps. Hence the metadata is 
+Time stamped maps can registered in and unregistered from space time
+datasets. The spatio-temporal extent as well as the metadata of a space
+time dataset is derived from its registered maps. Hence the metadata is
 dependent from the dataset type (raster, 3D raster, vector).
 
 <h2>EXAMPLE</h2>
 
-In this example we create 7 raster maps using r.mapcalc with random 
-values that will be registered in a single space time raster dataset 
-named <em>precipitation_daily</em> using a daily temporal granularity. 
-The names of the raster maps are stored in a text file that is used for 
-raster map registration. We use <em>t.create</em> for the space time 
-raster dataset creation and <em>t.register</em> to register the raster 
-maps in the space time raster dataset. At the end we report 
-informations about the space time raster dataset to stdout using 
-<em>t.info</em>.
+<h3>Absolute STRDS dataset</h3>
 
-<div class="code"><pre>
-
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
-
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = rand(0, 10)" -s
-    echo ${map} >> map_list.txt 
-done
+Create a raster space time datasets
 
+<div class="code"><pre>
 t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
+         output=precipitation_monthly \
+         title="Monthly precipitation" \
+         description="Dataset with monthly precipitation"
+</pre></div>
 
-t.register -i type=rast input=precipitation_daily \
-           file=map_list.txt start=2012-08-20 increment="1 days"
+<h3>Relative STVDS dataset</h3>
 
-t.info type=strds input=precipitation_daily
+Create a vector space time datasets
 
- +-------------------- Space Time Raster Dataset -----------------------------+
- |                                                                            |
- +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@soeren
- | Name: ...................... precipitation_daily
- | Mapset: .................... soeren
- | Creator: ................... soeren
- | 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-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:...................... 0.0
- | East:.. .................... 120.0
- | West:....................... 0.0
- | Top:........................ 0.0
- | Bottom:..................... 0.0
- +-------------------- Metadata information ----------------------------------+
- | 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:
- | Daily precipitation
- | Description:
- | Test dataset with daily precipitation
- | Command history:
- | # 2014-11-23 15:18:42 
- | t.create type="strds" temporaltype="absolute"
- |     output="precipitation_daily" title="Daily precipitation"
- |     description="Test dataset with daily precipitation"
- | # 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"
- | 
- +----------------------------------------------------------------------------+
+<div class="code"><pre>
+t.create type=stvds temporaltype=relative \
+         output=precipitation_monthly_30y \
+         title="Monthly precipitation 30 years" \
+         description="Test dataset with monthly average \
+         precipitation in the last 30 year"
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.info/t.info.html

@@ -1,140 +1,130 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.info</em> reports informations about any dataset that is 
-registered in the temporal database in human readable or shell script 
-style. Datasets are raster, 3D raster and vector maps as well as their 
-corresponding space time datasets (STRDS, STR3DS and STVDS). This 
-module reports the informations that are stored in the temporal 
-database. These are basic informations (id, name, mapset, creator, 
-creation time, temporal type), the temporal and spatial extent and 
-dataset type specific metadata. The user has to utilize <em>r.info</em>, 
-<em>r3.info</em>, <em>v.info</em> to report detailed informations about 
-raster, 3D raster and vector maps, since not all map specific 
-informations and metadata are stored in the temporal database. 
+<em>t.info</em> reports informations about any dataset that is
+registered in the temporal database in human readable or shell script
+style. Datasets are raster, 3D raster and vector maps as well as their
+corresponding space time datasets (STRDS, STR3DS and STVDS). This
+module reports the informations that are stored in the temporal
+database. These are basic informations (id, name, mapset, creator,
+creation time, temporal type), the temporal and spatial extent and
+dataset type specific metadata. The user has to utilize <em>r.info</em>,
+<em>r3.info</em>, <em>v.info</em> to report detailed informations about
+raster, 3D raster and vector maps, since not all map specific
+informations and metadata are stored in the temporal database.
 <p>
-In addition, informations about the chosen temporal database backend 
+In addition, informations about the chosen temporal database backend
 can be reported.
 
-<h2>EXAMPLE</h2>
+<h2>EXAMPLES</h2>
 
-In this example we first report temporal database backend information 
-using <em>t.info -s</em>. Then we create a single raster maps using 
-<em>r.mapcalc</em> with random values that will be registered in a 
-single space time raster dataset named <em>precipitation_daily</em> 
-using a daily temporal granularity. We use <em>t.create</em> for the 
-space time raster dataset creation and <em>t.register</em> to register 
-the raster map in the space time raster dataset. At the end we report 
-informations about the raster map and the space time raster dataset to 
-stdout.
+<h3>Temporal DBMI information</h3>
 
-<div class="code"><pre>
+In order to obtain information about temporal DBMI backend, run:
 
+<div class="code"><pre>
 t.info -s
  +------------------- Temporal DBMI backend information ----------------------+
  | DBMI Python interface:...... sqlite3
- | 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
+ | Temporal database string:... /grassdata/nc_spm_temporal_workshop/climate_2000_2012/tgis/sqlite.db
+ | SQL template path:.......... /usr/local/grass-7.0.0/etc/sql
  | tgis_db_version .......... 2
  | creation_time .......... 2014-11-22 20:06:46.863733
  | tgis_version .......... 2
  +----------------------------------------------------------------------------+
+</pre></div>
 
+<h3>space time dataset information</h3>
 
-r.mapcalc expr="map1 = rand(0, 10)" -s
-
-t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
-
-t.register -i type=rast input=precipitation_daily \
-           maps=map1 start=2012-08-20 increment="1 days"
-
-t.info type=rast input=map1
+In order to obtain information about a space time dataset, run:
 
- +-------------------- Raster Dataset ----------------------------------------+
+<div class="code"><pre>
+t.info in=tempmean_monthly
+ +-------------------- Space Time Raster Dataset -----------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ map1@soeren
- | Name: ...................... map1
- | Mapset: .................... soeren
- | Creator: ................... soeren
+ | Id: ........................ tempmean_monthly@climate_2000_2012
+ | Name: ...................... tempmean_monthly
+ | Mapset: .................... climate_2000_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-11-23 15:20:28.034464
+ | Creation time: ............. 2014-11-27 08:50:48.443229
+ | Modification time:.......... 2014-11-27 09:44:32.800282
+ | Semantic type:.............. mean
  +-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-20 00:00:00
- | End time:................... 2012-08-21 00:00:00
+ | Start time:................. 2009-01-01 00:00:00
+ | End time:................... 2013-01-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
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
  | Top:........................ 0.0
  | Bottom:..................... 0.0
  +-------------------- Metadata information ----------------------------------+
- | Datatype:................... CELL
- | Number of columns:.......... 8
- | Number of rows:............. 12
- | Number of cells:............ 96
- | North-South resolution:..... 10.0
- | East-west resolution:....... 10.0
- | Minimum value:.............. 0.0
- | Maximum value:.............. 9.0
- | Registered datasets ........ precipitation_daily@soeren
+ | Raster register table:...... raster_map_register_d567423784c740bea1fba75dc7c0fa3d
+ | North-South resolution min:. 500.0
+ | North-South resolution max:. 500.0
+ | East-west resolution min:... 500.0
+ | East-west resolution max:... 500.0
+ | Minimum value min:.......... -6.464337
+ | Minimum value max:.......... 18.54137
+ | Maximum value min:.......... 4.247691
+ | Maximum value max:.......... 28.805381
+ | Aggregation type:........... None
+ | Number of registered maps:.. 48
+ |
+ | Title:
+ | Monthly precipitation
+ | Description:
+ | Dataset with monthly precipitation
+ | Command history:
+ | # 2014-11-27 08:50:48
+ | t.create type="strds" temporaltype="absolute"
+ |     output="tempmean_monthly" title="Monthly precipitation"
+ |     description="Dataset with monthly precipitation"
+ | # 2014-11-27 09:44:32
+ | t.register -i type="rast" inp="tempmean_monthly" maps="2009_01_tempmean,...,2012_12_tempmean" start="2009-01-01" increment="1 months"
+ |
  +----------------------------------------------------------------------------+
+</pre></div>
 
+<h3>Temporal maps information</h3>
 
-t.info type=strds input=precipitation_daily
+In order to obtain information about a map in a space time dataset, run:
 
- +-------------------- Space Time Raster Dataset -----------------------------+
+<div class="code"><pre>
+t.info in=2009_01_tempmean type=rast
+ +-------------------- Raster Dataset ----------------------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@soeren
- | Name: ...................... precipitation_daily
- | Mapset: .................... soeren
- | Creator: ................... soeren
+ | Id: ........................ 2009_01_tempmean@climate_2000_2012
+ | Name: ...................... 2009_01_tempmean
+ | Mapset: .................... climate_2000_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-11-23 15:20:27.587727
- | Modification time:.......... 2014-11-23 15:20:28.054839
- | Semantic type:.............. mean
+ | Creation time: ............. 2014-11-27 09:44:26.280147
  +-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-20 00:00:00
- | End time:................... 2012-08-21 00:00:00
- | Granularity:................ 1 day
- | Temporal type of maps:...... interval
+ | Start time:................. 2009-01-01 00:00:00
+ | End time:................... 2009-02-01 00:00:00
  +-------------------- Spatial extent ----------------------------------------+
- | North:...................... 80.0
- | South:...................... 0.0
- | East:.. .................... 120.0
- | West:....................... 0.0
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
  | Top:........................ 0.0
  | Bottom:..................... 0.0
  +-------------------- Metadata information ----------------------------------+
- | 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:
- | Daily precipitation
- | Description:
- | Test dataset with daily precipitation
- | Command history:
- | # 2014-11-23 15:20:27 
- | t.create type="strds" temporaltype="absolute"
- |     output="precipitation_daily" title="Daily precipitation"
- |     description="Test dataset with daily precipitation"
- | # 2014-11-23 15:20:28 
- | t.register -i type="rast" input="precipitation_daily"
- |     maps="map1" start="2012-08-20" increment="1 days"
- | 
+ | Datatype:................... DCELL
+ | Number of columns:.......... 620
+ | Number of rows:............. 1630
+ | Number of cells:............ 1010600
+ | North-South resolution:..... 500.0
+ | East-west resolution:....... 500.0
+ | Minimum value:.............. -3.380823
+ | Maximum value:.............. 7.426054
+ | Registered datasets ........ tempmean_monthly@climate_2000_2012
  +----------------------------------------------------------------------------+
 </pre></div>
 

temporal/t.list/t.list.html

@@ -1,53 +1,46 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.list</em> lists any dataset that is registered in the temporal 
-database. Datasets are raster, 3D raster and vector maps as well as 
-their corresponding space time datasets (STRDS, STR3DS and STVDS). The 
-type of the dataset can be specified using the <em>type</em> option, 
-default is STRDS. By default all datasets with relative and absolute 
-time are listed. However, the user has the ability to specify a single 
-temporal type with the <em>temporaltype</em> option. The user can 
-define the columns that should be printed for each dataset and the 
-order of the datasets. In addition a SQL WHERE statement can be 
+<em>t.list</em> lists any dataset that is registered in the temporal
+database. Datasets are raster, 3D raster and vector maps as well as
+their corresponding space time datasets (STRDS, STR3DS and STVDS). The
+type of the dataset can be specified using the <em>type</em> option,
+default is STRDS. By default all datasets with relative and absolute
+time are listed. However, the user has the ability to specify a single
+temporal type with the <em>temporaltype</em> option. The user can
+define the columns that should be printed for each dataset and the
+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 
+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>
+<h2>EXAMPLES</h2>
 
-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:
+In order to obtain the list of raster space time dataset
 
 <div class="code"><pre>
-# Generate data
-r.mapcalc expr="map1 = rand(0,  10)" -s
-r.mapcalc expr="map2 = rand(10, 20)" -s
-r.mapcalc expr="map3 = rand(20, 30)" -s
+t.list strds
+----------------------------------------------
+Space time raster datasets with absolute time available in mapset &#60;climate_2000_2012&#62;:
+tempmean_monthly@climate_2000_2012
+</pre></div>
 
-t.register type=rast maps=map1 start=2012-08-20 end=2012-08-21
-t.register type=rast maps=map2 start=2012-08-21 end=2012-08-22
-t.register type=rast maps=map3 start=2012-08-22 end=2012-08-23
+Tha user can obtain also the list of raster contained into temporal
+datasets
 
+<div class="code"><pre>
 t.list rast
- map1@soeren
- map2@soeren
- map3@soeren
-
-t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
-         
-t.register type=rast input=precipitation_daily maps=map1,map2,map3
-
-t.list strds
- precipitation_daily@soeren
+Time stamped raster maps with absolute time available in mapset &#60;climate_2000_2012&#62;:
+2009_01_tempmean@climate_2000_2012
+2009_02_tempmean@climate_2000_2012
+2009_03_tempmean@climate_2000_2012
+...
+2012_10_tempmean@climate_2000_2012
+2012_11_tempmean@climate_2000_2012
+2012_12_tempmean@climate_2000_2012
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.rast.aggregate/t.rast.aggregate.html

@@ -1,206 +1,122 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.rast.aggregate</em> temporally aggregates space time raster 
-datasets by a specific temporal granularity. This module support 
-<em>absolute</em> and <em>relative time</em>. The temporal granularity 
-of absolute time can be <em>seconds, minutes, hours, days, weeks, 
-months</em> or <em>years</em>. Mixing of granularities eg. "1 year, 3 
-months 5 days" is not supported. In case of relative time the temporal 
-unit of the input space time raster dataset is used. The granularity 
-must be specified with an integer value. 
+<em>t.rast.aggregate</em> temporally aggregates space time raster
+datasets by a specific temporal granularity. This module support
+<em>absolute</em> and <em>relative time</em>. The temporal granularity
+of absolute time can be <em>seconds, minutes, hours, days, weeks,
+months</em> or <em>years</em>. Mixing of granularities eg. "1 year, 3
+months 5 days" is not supported. In case of relative time the temporal
+unit of the input space time raster dataset is used. The granularity
+must be specified with an integer value.
 <p>
-This module is sensitive to the current region and mask settings, 
-hence spatial extent and spatial resolution. In case the registered 
-raster maps of the input space time raster dataset have different 
-spatial resolutions, the default nearest neighbor resampling method 
+This module is sensitive to the current region and mask settings,
+hence spatial extent and spatial resolution. In case the registered
+raster maps of the input space time raster dataset have different
+spatial resolutions, the default nearest neighbor resampling method
 is used for runtime spatial aggregation.
 
 <h2>NOTES</h2>
 
-The raster module <em>r.series</em> is used internally. Hence all 
+The raster module <em>r.series</em> is used internally. Hence all
 aggregate methods of <em>r.series</em> are supported. See the
 <a href="r.series.html">r.series</a> manual page for details.
 <p>
-This module will shift the start date for each aggregation process 
-depending on the provided temporal granularity. The following shifts 
+This module will shift the start date for each aggregation process
+depending on the provided temporal granularity. The following shifts
 will performed:
 
 <ul>
-    <li><em>granularity years</em>: will start at the first of January, 
+    <li><em>granularity years</em>: will start at the first of January,
       hence 14-08-2012 00:01:30 will be shifted to 01-01-2012 00:00:00</li>
-    <li><em>granularity months</em>: will start at the first day of a month, 
+    <li><em>granularity months</em>: will start at the first day of a month,
       hence 14-08-2012 will be shifted to 01-08-2012 00:00:00</li>
-    <li><em>granularity weeks</em>: will start at the first day of a week (Monday), 
+    <li><em>granularity weeks</em>: will start at the first day of a week (Monday),
       hence 14-08-2012 01:30:30 will be shifted to 13-08-2012 01:00:00</li>
-    <li><em>granularity days</em>: will start at the first hour of a day, 
+    <li><em>granularity days</em>: will start at the first hour of a day,
       hence 14-08-2012 00:01:30 will be shifted to 14-08-2012 00:00:00</li>
-    <li><em>granularity hours</em>: will start at the first minute of a hour, 
+    <li><em>granularity hours</em>: will start at the first minute of a hour,
       hence 14-08-2012 01:30:30 will be shifted to 14-08-2012 01:00:00</li>
-    <li><em>granularity minutes</em>: will start at the first second of a minute, 
+    <li><em>granularity minutes</em>: will start at the first second of a minute,
       hence 14-08-2012 01:30:30 will be shifted to 14-08-2012 01:30:00</li>
 </ul>
 
 <p>
-The specification of the temporal relation between the aggregation 
-intervals and the raster map layers is always formulated from the 
-aggregation interval viewpoint. Hence, the relation <em>contains</em> 
-has to be specified to aggregate map layer that are temporally located 
+The specification of the temporal relation between the aggregation
+intervals and the raster map layers is always formulated from the
+aggregation interval viewpoint. Hence, the relation <em>contains</em>
+has to be specified to aggregate map layer that are temporally located
 in an aggregation interval.
 <p>
-Parallel processing is supported in case that more than one interval is 
-available for aggregation computation. Internally several 
-<em>r.series</em> modules will be started, depending on the number of 
-specified parallel processes (<em>nprocs</em>) and the number of 
-intervals to aggregate. 
-
-<h2>EXAMPLES</h2>
-
-In this example, we create 7 raster maps that will be registered in a 
-single space time raster dataset named <em>precipitation_daily</em> 
-using a daily temporal granularity. The names of the raster maps are 
-stored in a text file that is used for raster map registration. 
-<p>
-The space time raster dataset <em>precipitation_daily</em> with daily 
-temporal granularity will be aggregated to weekly precipitation 
-resulting in the output space time raster dataset 
-<em>precipitation_weekly</em>. The base name of the new generated 
-raster maps is <em>prec_weekly</em>, the granularity is 1 week. The 
-aggregation method is set to <em>sum</em> to accumulate the 
-precipitation values of all raster maps that are temporally 
-<em>contained</em> in a week. The sampling option <em>contains</em> 
-assures that only raster maps that are temporally during a week will be 
-considered for computation: 
-
-<div class="code"><pre>
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
+Parallel processing is supported in case that more than one interval is
+available for aggregation computation. Internally several
+<em>r.series</em> modules will be started, depending on the number of
+specified parallel processes (<em>nprocs</em>) and the number of
+intervals to aggregate.
 
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = 1" 
-    echo ${map} >> map_list.txt 
-done
+<h2>EXAMPLE</h2>
 
-t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
+In this example the user is going to aggregate monthly data into yearly
+data, running:
 
-t.register -i type=rast input=precipitation_daily \
-           file=map_list.txt start="2012-08-20" increment="1 days"
+<div class="code"><pre>
+t.rast.aggregate in=tempmean_monthly out=tempmean_yearly basename=tempmean_year \
+                 granularity='1 year' method=average
 
-t.info type=strds input=precipitation_daily
+t.support input=tempmean_yearly \
+          title="Yearly precipitation" \
+          description="Aggregated precipitation dataset with yearly resolution"
 
+t.info tempmean_yearly
  +-------------------- Space Time Raster Dataset -----------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@PERMANENT
- | Name: ...................... precipitation_daily
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
+ | Id: ........................ tempmean_yearly@climate_2000_2012
+ | Name: ...................... tempmean_yearly
+ | Mapset: .................... climate_2000_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-08-25 11:26:43.088786
- | Modification time:.......... 2014-08-25 11:26:43.533237
+ | Creation time: ............. 2014-11-27 10:25:21.243319
+ | Modification time:.......... 2014-11-27 10:25:21.862136
  | Semantic type:.............. mean
  +-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-20 00:00:00
- | End time:................... 2012-08-27 00:00:00
- | Granularity:................ 1 day
+ | Start time:................. 2009-01-01 00:00:00
+ | End time:................... 2013-01-01 00:00:00
+ | Granularity:................ 1 year
  | Temporal type of maps:...... interval
  +-------------------- Spatial extent ----------------------------------------+
- | North:...................... 80.0
- | South:...................... 0.0
- | East:.. .................... 120.0
- | West:....................... 0.0
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
  | Top:........................ 0.0
  | Bottom:..................... 0.0
  +-------------------- Metadata information ----------------------------------+
- | Raster register table:...... raster_map_register_68033ba1bca64b33a49a3b356dcfaf9b
- | 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
+ | Raster register table:...... raster_map_register_514082e62e864522a13c8123d1949dea
+ | North-South resolution min:. 500.0
+ | North-South resolution max:. 500.0
+ | East-west resolution min:... 500.0
+ | East-west resolution max:... 500.0
+ | Minimum value min:.......... 7.370747
+ | Minimum value max:.......... 8.81603
+ | Maximum value min:.......... 17.111387
+ | Maximum value max:.......... 17.915511
+ | Aggregation type:........... average
+ | Number of registered maps:.. 4
  |
- | Title:
- | Daily precipitation
- | Description:
- | Test dataset with daily precipitation
+ | Title: Yearly precipitation
+ | Monthly precipitation
+ | Description: Aggregated precipitation dataset with yearly resolution
+ | Dataset with monthly precipitation
  | Command history:
- | # 2014-08-25 11:26:43 
- | t.create type="strds" temporaltype="absolute"
- |     output="precipitation_daily" title="Daily precipitation"
- |     description="Test dataset with daily precipitation"
- | # 2014-08-25 11:26:43 
- | t.register -i type="rast" input="precipitation_daily"
- |     file="map_list.txt" start="2012-08-20" increment="1 days"
- | 
- +----------------------------------------------------------------------------+
-
-t.rast.aggregate input=precipitation_daily \
-                 output=precipitation_weekly \
-                 base=prec_weekly granularity="1 week" \
-                 method=sum sampling=contains
-
-t.support input=precipitation_weekly \
-          title="Weekly precipitation" \
-          description="Aggregated precipitation dataset with weekly resolution"
-                 
-t.info type=strds input=precipitation_weekly
-
- +-------------------- Space Time Raster Dataset -----------------------------+
- |                                                                            |
- +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_weekly@PERMANENT
- | Name: ...................... precipitation_weekly
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
- | Temporal type: ............. absolute
- | Creation time: ............. 2014-08-25 11:33:25.253525
- | Modification time:.......... 2014-08-25 11:33:31.015648
- | Semantic type:.............. mean
- +-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-20 00:00:00
- | End time:................... 2012-08-27 00:00:00
- | Granularity:................ 7 days
- | 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_ea1008db0c374501a340f49e46ab24af
- | 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:.......... 7.0
- | Minimum value max:.......... 7.0
- | Maximum value min:.......... 7.0
- | Maximum value max:.......... 7.0
- | Aggregation type:........... sum
- | Number of registered maps:.. 1
+ | # 2014-11-27 10:25:21
+ | t.rast.aggregate in="tempmean_monthly"
+ |     out="tempmean_yearly" basename="tempmean_year" granularity="1 years"
+ |     method="average"
  |
- | Title:
- | Weekly precipitation
- | Description:
- | Aggregated precipitation dataset with weekly resolution
- | Command history:
- | # 2014-08-25 11:33:25 
- | t.rast.aggregate input="precipitation_daily"
- |     output="precipitation_weekly" base="prec_weekly" granularity="1 week"
- |     method="sum" sampling="contains"
- | # 2014-08-25 11:33:31 
- | t.support input="precipitation_weekly"
- |     title="Weekly precipitation"
- |     description="Aggregated precipitation dataset with weekly resolution"
- | 
+ | # 2014-11-27 10:26:21
+ | t.support input=tempmean_yearly \
+ |        title="Yearly precipitation" \
+ |        description="Aggregated precipitation dataset with yearly resolution"
  +----------------------------------------------------------------------------+
 </pre></div>
 

temporal/t.rast.colors/t.rast.colors.html

@@ -1,58 +1,57 @@
 <h2>DESCRIPTION</h2>
 
 <em>t.rast.colors</em> computes a color table based on all registered maps
-of a space time raster dataset and to assign this color table to each map. 
-Hence the created color table reflects the data range of 
-the space time raster dataset. This module is a simple 
-wrapper around <a href="r.colors.html">r.colors</a>. 
+of a space time raster dataset and to assign this color table to each map.
+Hence the created color table reflects the data range of
+the space time raster dataset. This module is a simple
+wrapper around <a href="r.colors.html">r.colors</a>.
 All options of <em>r.colors</em> are supported.
-Internally a file with map names is created and passed 
+Internally a file with map names is created and passed
 to the <em>file</em> option of <em>r.colors</em>.
 <p>
-Please have a look at the <a href="r.colors.html">r.colors</a> 
+Please have a look at the <a href="r.colors.html">r.colors</a>
 manual page for further informations.
 
 <h2>EXAMPLE</h2>
 
-In this example we create six raster maps that will be registered in a 
-single space time raster dataset named <em>precip_abs</em> using a 
-monthly temporal granularity. Then we set an equilized grey color table 
-using <em>t.rast.colors</em> and print the color table of the first map 
-to stdout representing the data range of the space time raster dataset.
+Set Celsius color table to monthly dataset
 
 <div class="code"><pre>
-g.region s=0 n=80 w=0 e=120 b=0 t=50 res=10 res3=10 -p3
+t.rast.colors input=tempmean_monthly color=celsius
 
-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"
+r.colors.out map=2009_01_tempmean
 
-t.create type=strds temporaltype=absolute \
-    output=precip_abs title="Color setting example" \
-    descr="Color setting example"
-
-t.register type=rast input=precip_abs \
-    maps=prec_1,prec_2,prec_3,prec_4,prec_5,prec_6 \
-    start="2001-01-01" increment="1 months"
-
-# Grey color table for the full range 100 - 600
-t.rast.colors input=precip_abs color=grey.eq
-r.colors.out map=prec_1
-
-100 21:21:21
-199 21:21:21
-200 64:64:64
-299 64:64:64
-300 106:106:106
-399 106:106:106
-400 149:149:149
-499 149:149:149
-500 192:192:192
-599 192:192:192
-600 234:234:234
+-80 0:0:40
+-40 91:10:168
+-30 220:220:220
+-25 91:50:128
+-20 50:0:150
+-15 4:25:130
+-10 8:54:106
+-8 4:20:150
+-5 0:50:255
+-2 8:10:118
+-0.061449 8:113:155
+0.013855 8:118:157
+0.090594 8:123:158
+0.168767 8:128:159
+0.248375 8:133:159
+0.329417 8:136:160
+...
+40.6976 183:163:163
+41.0483 185:167:167
+41.4004 188:170:171
+41.754 190:174:174
+42.109 191:178:178
+42.4655 193:182:182
+42.8233 195:185:185
+43.1827 197:189:189
+43.5434 199:192:193
+43.9056 200:197:197
+44.2692 202:200:201
+44.6342 204:204:204
+45.0007 206:206:206
+80 155:10:155
 nv 255:255:255
 default 255:255:255
 </pre></div>

temporal/t.rast.export/t.rast.export.html

@@ -1,67 +1,59 @@
 <h2>DESCRIPTION</h2>
 
-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 <em>r.out.bin</em>. The map specific color tables 
+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 <em>r.out.bin</em>. The map specific color tables
 are exported in case of GeoTIFF files. In addition several metadata files
 are created in the archive that describe the temporal 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 
-maps, the chosen export format and some other metadata. The "proj.txt" 
-files stores the projection information as proj4 string of the location 
-the space time raster dataset was exported from. The file "readme.txt" 
-describes the file format. The output of <em>r.info</em> is stored in 
+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
+maps, the chosen export format and some other metadata. The "proj.txt"
+files stores the projection information as proj4 string of the location
+the space time raster dataset was exported from. The file "readme.txt"
+describes the file format. The output of <em>r.info</em> is stored in
 "metadata.txt".
 <p>
-The tar archive can be compressed using the <b>compress</b> option. 
-Gzip and bzip2 are available. A <b>where</b> option can be specified, 
-to export only a subset of the space time dataset. Archives exported 
+The tar archive can be compressed using the <b>compress</b> option.
+Gzip and bzip2 are available. A <b>where</b> option can be specified,
+to export only a subset of the space time dataset. Archives exported
 with <em>t.rast.export</em> can be importet with <em>t.rast.import</em>.
 
 <h2>EXAMPLE</h2>
 
-In this example we create 7 raster maps that will be registered in a 
-single space time raster dataset named <em>precipitation_daily</em> 
-using a daily temporal granularity. The names of the raster maps are 
-stored in a text file that is used for raster map registration. We 
-export the created space time raster dataset and will have a look at 
-some files that are created: 
+In this example all the maps of 2012 of tempmean_monthly will be exported
 
 <div class="code"><pre>
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
-
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = 1" 
-    echo ${map} >> map_list.txt 
-done
-
-t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
-
-t.register -i type=rast input=precipitation_daily \
-           file=map_list.txt start="2012-08-20" increment="1 days"
-
-t.rast.export input=precipitation_daily output=precipitation_daily.tar
+t.rast.export input=tempmean_monthly output=tempmean_monthly.tar.bzip2 \
+              where="start_time >= '2012-01-01' and start_time < '2013-01-01'"
 
 tar xvf precipitation_daily.tar
-map_1.tif
-map_1.color
-map_2.tif
-map_2.color
-map_3.tif
-map_3.color
-map_4.tif
-map_4.color
-map_5.tif
-map_5.color
-map_6.tif
-map_6.color
-map_7.tif
-map_7.color
+
+2012_01_tempmean.tif
+2012_01_tempmean.color
+2012_02_tempmean.tif
+2012_02_tempmean.color
+2012_03_tempmean.tif
+2012_03_tempmean.color
+2012_04_tempmean.tif
+2012_04_tempmean.color
+2012_05_tempmean.tif
+2012_05_tempmean.color
+2012_06_tempmean.tif
+2012_06_tempmean.color
+2012_07_tempmean.tif
+2012_07_tempmean.color
+2012_08_tempmean.tif
+2012_08_tempmean.color
+2012_09_tempmean.tif
+2012_09_tempmean.color
+2012_10_tempmean.tif
+2012_10_tempmean.color
+2012_11_tempmean.tif
+2012_11_tempmean.color
+2012_12_tempmean.tif
+2012_12_tempmean.color
 list.txt
 proj.txt
 init.txt
@@ -74,32 +66,44 @@ stds_type=strds
 format=GTiff
 temporal_type=absolute
 semantic_type=mean
-number_of_maps=7
-north=80.0
-south=0.0
-east=120.0
-west=0.0
+number_of_maps=48
+north=320000.0
+south=10000.0
+east=935000.0
+west=120000.0
 
 
 cat proj.txt
-+proj=longlat
++proj=lcc
++lat_1=36.16666666666666
++lat_2=34.33333333333334
++lat_0=33.75
++lon_0=-79
++x_0=609601.22
++y_0=0
 +no_defs
 +a=6378137
-+rf=298.257223563
-+towgs84=0,0,0,0,0,0,0
++rf=298.257222101
++towgs84=0.000,0.000,0.000
++to_meter=1
 
 
 cat list.txt
-map_1|2012-08-20 00:00:00|2012-08-21 00:00:00
-map_2|2012-08-21 00:00:00|2012-08-22 00:00:00
-map_3|2012-08-22 00:00:00|2012-08-23 00:00:00
-map_4|2012-08-23 00:00:00|2012-08-24 00:00:00
-map_5|2012-08-24 00:00:00|2012-08-25 00:00:00
-map_6|2012-08-25 00:00:00|2012-08-26 00:00:00
-map_7|2012-08-26 00:00:00|2012-08-27 00:00:00
-
-
-cat readme.txt 
+2012_01_tempmean|2012-01-01 00:00:00|2012-02-01 00:00:00
+2012_02_tempmean|2012-02-01 00:00:00|2012-03-01 00:00:00
+2012_03_tempmean|2012-03-01 00:00:00|2012-04-01 00:00:00
+2012_04_tempmean|2012-04-01 00:00:00|2012-05-01 00:00:00
+2012_05_tempmean|2012-05-01 00:00:00|2012-06-01 00:00:00
+2012_06_tempmean|2012-06-01 00:00:00|2012-07-01 00:00:00
+2012_07_tempmean|2012-07-01 00:00:00|2012-08-01 00:00:00
+2012_08_tempmean|2012-08-01 00:00:00|2012-09-01 00:00:00
+2012_09_tempmean|2012-09-01 00:00:00|2012-10-01 00:00:00
+2012_10_tempmean|2012-10-01 00:00:00|2012-11-01 00:00:00
+2012_11_tempmean|2012-11-01 00:00:00|2012-12-01 00:00:00
+2012_12_tempmean|2012-12-01 00:00:00|2013-01-01 00:00:00
+
+
+cat readme.txt
 This space time raster dataset was exported with t.rast.export of GRASS GIS 7
 
 Files:

temporal/t.rast.extract/t.rast.extract.html

@@ -1,83 +1,57 @@
 <h2>DESCRIPTION</h2>
 
-The purpose of <b>t.rast.extract</b> is to extract a subset of a space 
-time raster dataset and to store that subset in a different space time 
-raster dataset. The <b>where</b> condition is used to select the 
-subset. In addition a <em>r.mapcalc</em> sub-expression can be 
-specified that performs operations on all maps of the selected subset. 
-In this expression the name of the input space time raster dataset can 
-be used as simple map name. Other STRDS than the input STRDS can not be 
-specified, but any raster map. In case a <em>r.mapcalc</em> 
-sub-expression is defined, the base name of the resulting raster maps 
-must be specified. The <em>r.mapcalc</em> expression can be used to 
-select maps as well, since by default resulting empty maps are not 
-registered in the output space time raster dataset and removed after 
-processing. The number of parallel GRASS GIS processes can be specified 
+The purpose of <b>t.rast.extract</b> is to extract a subset of a space
+time raster dataset and to store that subset in a different space time
+raster dataset. The <b>where</b> condition is used to select the
+subset. In addition a <em>r.mapcalc</em> sub-expression can be
+specified that performs operations on all maps of the selected subset.
+In this expression the name of the input space time raster dataset can
+be used as simple map name. Other STRDS than the input STRDS can not be
+specified, but any raster map. In case a <em>r.mapcalc</em>
+sub-expression is defined, the base name of the resulting raster maps
+must be specified. The <em>r.mapcalc</em> expression can be used to
+select maps as well, since by default resulting empty maps are not
+registered in the output space time raster dataset and removed after
+processing. The number of parallel GRASS GIS processes can be specified
 to speed up the processing.
 <p>
-If no <em>r.mapcalc</em> expression is defined, the selected maps are 
-simply registered in the new created output space time raster dataset 
+If no <em>r.mapcalc</em> expression is defined, the selected maps are
+simply registered in the new created output space time raster dataset
 to avoid data duplication.
 
 <h2>Note</h2>
 
 The <em>r.mapcalc</em> sub-expression should not contain the left side
 <tt>"map ="</tt> of a full <em>r.mapcalc</em> expression, only the right
-side, eg.: 
+side, eg.:
 
 
 <div class="code"><pre>
-t.rast.extract input=precipitation where="start_time > '2001-01-05'" \
-               output=selected_precipitation base=new_prec_map \
-               expression="if(precipitation < 5, null(), precipitation)"
+t.rast.extract input=tempmean_monthly where="start_time > '2010-01-05'" \
+               output=selected_tempmean_monthly base=new_tmean_month \
+               expression="if(tempmean_monthly < 0, null(), tempmean_monthly)"
 </div>
 
 <h2>EXAMPLE</h2>
 
-In this example we create 8 raster maps that will be registered in a 
-single space time raster dataset named <em>precipitation_yearly</em> 
-using a yearly temporal granularity. The names of the raster maps are 
-stored in a text file that is used for raster map registration.
-<p>
-Then we extract all maps that are later 2005 and store the selected maps in
-the space time raster dataset <em>precipitation_yearly_later_2005</em>.
-<p>
-
 <div class="code"><pre>
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7 map_8"
-
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = 1" 
-    echo ${map} >> map_list.txt 
-done
-
-t.create type=strds temporaltype=absolute \
-         output=precipitation_yearly \
-         title="Yearly precipitation" \
-         description="Test dataset with yearly precipitation"
-
-t.register -i type=rast input=precipitation_yearly \
-           file=map_list.txt start="2000-01-01" increment="1 year"
-
-t.rast.list precipitation_yearly
-
-map_1   test    2000-01-01 00:00:00 2001-01-01 00:00:00
-map_2   test    2001-01-01 00:00:00 2002-01-01 00:00:00
-map_3   test    2002-01-01 00:00:00 2003-01-01 00:00:00
-map_4   test    2003-01-01 00:00:00 2004-01-01 00:00:00
-map_5   test    2004-01-01 00:00:00 2005-01-01 00:00:00
-map_6   test    2005-01-01 00:00:00 2006-01-01 00:00:00
-map_7   test    2006-01-01 00:00:00 2007-01-01 00:00:00
-map_8   test    2007-01-01 00:00:00 2008-01-01 00:00:00
-
-t.rast.extract input=precipitation_yearly output=precipitation_yearly_later_2005 \
-               where="start_time >= '2005-01-01'"
-
-t.rast.list precipitation_yearly_later_2005
-
-map_6   test    2005-01-01 00:00:00 2006-01-01 00:00:00
-map_7   test    2006-01-01 00:00:00 2007-01-01 00:00:00
-map_8   test    2007-01-01 00:00:00 2008-01-01 00:00:00
+t.rast.extract input=tempmean_monthly output=tempmean_monthly_later_2012 \
+               where="start_time >= '2012-01-01'"
+
+t.rast.list tempmean_monthly_later_2012
+name|mapset|start_time|end_time
+2012_01_tempmean|climate_2000_2012|2012-01-01 00:00:00|2012-02-01 00:00:00
+2012_02_tempmean|climate_2000_2012|2012-02-01 00:00:00|2012-03-01 00:00:00
+2012_03_tempmean|climate_2000_2012|2012-03-01 00:00:00|2012-04-01 00:00:00
+2012_04_tempmean|climate_2000_2012|2012-04-01 00:00:00|2012-05-01 00:00:00
+2012_05_tempmean|climate_2000_2012|2012-05-01 00:00:00|2012-06-01 00:00:00
+2012_06_tempmean|climate_2000_2012|2012-06-01 00:00:00|2012-07-01 00:00:00
+2012_07_tempmean|climate_2000_2012|2012-07-01 00:00:00|2012-08-01 00:00:00
+2012_08_tempmean|climate_2000_2012|2012-08-01 00:00:00|2012-09-01 00:00:00
+2012_09_tempmean|climate_2000_2012|2012-09-01 00:00:00|2012-10-01 00:00:00
+2012_10_tempmean|climate_2000_2012|2012-10-01 00:00:00|2012-11-01 00:00:00
+2012_11_tempmean|climate_2000_2012|2012-11-01 00:00:00|2012-12-01 00:00:00
+2012_12_tempmean|climate_2000_2012|2012-12-01 00:00:00|2013-01-01 00:00:00
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.rast.import/t.rast.import.html

@@ -1,64 +1,24 @@
 <h2>DESCRIPTION</h2>
 
 <em>t.rast.import</em> imports a space time raster dataset archive that
-was exported with <a href="t.rast.export.html">t.rast.export</a>. 
+was exported with <a href="t.rast.export.html">t.rast.export</a>.
 
 <h2>NOTE</h2>
 
-Optionally a base map name can be provided to avoid that existing 
-raster maps are overwritten by the map names that are used in the STRDS 
+Optionally a base map name can be provided to avoid that existing
+raster maps are overwritten by the map names that are used in the STRDS
 archive.
 
 <h2>EXAMPLE</h2>
 
-In this example we create seven raster maps that will be registered in a 
-single space time raster dataset named <em>precipitation_daily</em> 
-using a daily temporal granularity. The names of the raster maps are 
-stored in a text file that is used for raster map registration. We 
-export the created space time raster dataset and will import it again.
+Inside the North Carolina space time dataset it is possible to find a package
+called <em>lst_daily.tar.bzip2</em> with daily data from MODIS LST. Try
+to import it running:
 
 <div class="code"><pre>
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
+t.rast.import input=lst_daily.tar.bzip2 output=lst_daily \
+              base=lst extrdir=/tmp
 
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = 1" 
-    echo ${map} >> map_list.txt 
-done
-
-t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
-
-t.register -i type=rast input=precipitation_daily \
-           file=map_list.txt start="2012-08-20" increment="1 days"
-
-t.rast.list precipitation_daily
-
-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
-t.rast.import input=precipitation_daily.tar.gz output=new_precipitation_daily \
-              base=new_map extrdir=/tmp
-              
-t.rast.list new_precipitation_daily
-
-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>

temporal/t.rast.list/t.rast.list.html

@@ -1,24 +1,24 @@
 <h2>DESCRIPTION</h2>
 
-List time stamped raster map layers that are registered in a space time 
-raster dataset. <em>t.rast.list</em> provides several options to list map layers 
-and their metadata. Listing of map layer can be ordered by metadata, 
-metadata columns can be specified and SQL where conditions can be 
-provided to select a map layer subset of the input space time raster 
-dataset. Most of the raster map  specific metadat is available for 
+List time stamped raster map layers that are registered in a space time
+raster dataset. <em>t.rast.list</em> provides several options to list map layers
+and their metadata. Listing of map layer can be ordered by metadata,
+metadata columns can be specified and SQL where conditions can be
+provided to select a map layer subset of the input space time raster
+dataset. Most of the raster map  specific metadat is available for
 column selection, sorting and SQL where statements.
 
-Using the <b>method</b> option allows the specification of different 
-methods to list map layers. Method <i>col</i> is the deafult option and 
-sensitive to the <b>column</b>,<b>order</b> and <b>where</b> options. 
-It will simply print user specified metadata columns of one map layer 
-per line. The <i>comma</i> method will list the map layer as comma 
+Using the <b>method</b> option allows the specification of different
+methods to list map layers. Method <i>col</i> is the deafult option and
+sensitive to the <b>column</b>,<b>order</b> and <b>where</b> options.
+It will simply print user specified metadata columns of one map layer
+per line. The <i>comma</i> method will list the map layer as comma
 separated list that can be used as input for spatial modules.
 <p>
-To print interval length in days and distance from the begin use method 
-<i>delta</i>. Method <i>deltagap</i> will additionally print temporal 
-gaps between map layer. The <i>gran</i> method allows the listing of 
-map layer sampled by a user defined <b>granule</b>. As default the 
+To print interval length in days and distance from the begin use method
+<i>delta</i>. Method <i>deltagap</i> will additionally print temporal
+gaps between map layer. The <i>gran</i> method allows the listing of
+map layer sampled by a user defined <b>granule</b>. As default the
 granularity of the space time raster dataset is used for sampling.
 
 For user defined column separator can be specified with the <b>separator</b>
@@ -28,151 +28,126 @@ option.
 
 This example shows several options that are available for map layers listing.
 
+<h3>Default query</h3>
+
+The following command is the default one, returning standard information
+like name, mapset, start_time, end_time of each map in the space time dataset
+
 <div class="code"><pre>
-g.region s=0 n=80 w=0 e=120 b=0 t=50 res=10 res3=10 -p3
-
-# Generate data
-r.mapcalc expr="map_1 = rand(0, 550)" -s
-r.mapcalc expr="map_2 = rand(0, 450)" -s
-r.mapcalc expr="map_3 = rand(0, 320)" -s
-r.mapcalc expr="map_4 = rand(0, 510)" -s
-r.mapcalc expr="map_5 = rand(0, 300)" -s
-r.mapcalc expr="map_6 = rand(0, 650)" -s
-
-cat > map_list.txt << EOF
-map_1|2001-01-01|2001-04-01
-map_2|2001-05-01|2001-07-01
-map_3|2001-08-01|2001-10-01
-map_4|2001-11-01|2002-01-01
-map_5|2002-02-01|2002-04-01
-map_6|2002-05-01|2002-07-01
-EOF
-
-t.create type=strds temporaltype=absolute \
-         output=test_strds \
-         title="Test STRDS" \
-         description="Test dataset"
-
-t.register type=rast -i input=test_strds file=map_list.txt
-
-t.rast.list method=comma input=test_strds
-map_1@PERMANENT,map_2@PERMANENT,map_3@PERMANENT,map_4@PERMANENT,map_5@PERMANENT,map_6@PERMANENT
-
-t.rast.list method=col input=test_strds
+t.rast.list tempmean_monthly
 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
-map_4|PERMANENT|2001-11-01 00:00:00|2002-01-01 00:00:00
-map_5|PERMANENT|2002-02-01 00:00:00|2002-04-01 00:00:00
-map_6|PERMANENT|2002-05-01 00:00:00|2002-07-01 00:00:00
-
-t.rast.list  method=col input=test_strds columns=name,start_time,min,max
+2009_01_tempmean|climate_2000_2012|2009-01-01 00:00:00|2009-02-01 00:00:00
+2009_02_tempmean|climate_2000_2012|2009-02-01 00:00:00|2009-03-01 00:00:00
+....
+2012_11_tempmean|climate_2000_2012|2012-11-01 00:00:00|2012-12-01 00:00:00
+2012_12_tempmean|climate_2000_2012|2012-12-01 00:00:00|2013-01-01 00:00:00
+</pre></div>
+
+<h3>Add more info</h3>
+
+The following command let the user to choose the columns to show
+
+<div class="code"><pre>
+t.rast.list tempmean_monthly columns=name,start_time,min,max
 name|start_time|min|max
-map_1|2001-01-01 00:00:00|0.0|548.0
-map_2|2001-05-01 00:00:00|0.0|445.0
-map_3|2001-08-01 00:00:00|0.0|318.0
-map_4|2001-11-01 00:00:00|0.0|503.0
-map_5|2002-02-01 00:00:00|0.0|296.0
-map_6|2002-05-01 00:00:00|0.0|648.0
-
-t.rast.list  method=col input=test_strds columns=name,start_time,min,max where="max > 500"
+2009_01_tempmean|2009-01-01 00:00:00|-3.380823|7.426054
+2009_02_tempmean|2009-02-01 00:00:00|-1.820261|8.006386
+...
+2009_01_tempmean|2009-01-01 00:00:00|-3.380823|7.426054
+2009_02_tempmean|2009-02-01 00:00:00|-1.820261|8.006386
+</pre></div>
+
+<h3>Filtering the result</h3>
+
+In this example the result is filtered showing only the maps with max
+value major than 24
+
+<div class="code"><pre>
+t.rast.list tempmean_monthly columns=name,start_time,min,max where="max > 24"
 name|start_time|min|max
-map_1|2001-01-01 00:00:00|0.0|548.0
-map_4|2001-11-01 00:00:00|0.0|503.0
-map_6|2002-05-01 00:00:00|0.0|648.0
+2009_06_tempmean|2009-06-01 00:00:00|15.962669|25.819681
+2009_07_tempmean|2009-07-01 00:00:00|15.32852|26.103664
+2009_08_tempmean|2009-08-01 00:00:00|16.37995|27.293282
+....
+2012_06_tempmean|2012-06-01 00:00:00|14.929379|24.000651
+2012_07_tempmean|2012-07-01 00:00:00|18.455802|28.794653
+2012_08_tempmean|2012-08-01 00:00:00|15.718526|26.151115
+</pre></div>
 
-t.rast.list  method=delta input=test_strds
-id|name|mapset|start_time|end_time|interval_length|distance_from_begin
-map_1@PERMANENT|map_1|PERMANENT|2001-01-01 00:00:00|2001-04-01 00:00:00|90.0|0.0
-map_2@PERMANENT|map_2|PERMANENT|2001-05-01 00:00:00|2001-07-01 00:00:00|61.0|120.0
-map_3@PERMANENT|map_3|PERMANENT|2001-08-01 00:00:00|2001-10-01 00:00:00|61.0|212.0
-map_4@PERMANENT|map_4|PERMANENT|2001-11-01 00:00:00|2002-01-01 00:00:00|61.0|304.0
-map_5@PERMANENT|map_5|PERMANENT|2002-02-01 00:00:00|2002-04-01 00:00:00|59.0|396.0
-map_6@PERMANENT|map_6|PERMANENT|2002-05-01 00:00:00|2002-07-01 00:00:00|61.0|485.0
-
-t.rast.list  method=deltagaps input=test_strds
-id|name|mapset|start_time|end_time|interval_length|distance_from_begin
-map_1@PERMANENT|map_1|PERMANENT|2001-01-01 00:00:00|2001-04-01 00:00:00|90.0|0.0
-None|None|None|2001-04-01 00:00:00|2001-05-01 00:00:00|30.0|90.0
-map_2@PERMANENT|map_2|PERMANENT|2001-05-01 00:00:00|2001-07-01 00:00:00|61.0|120.0
-None|None|None|2001-07-01 00:00:00|2001-08-01 00:00:00|31.0|181.0
-map_3@PERMANENT|map_3|PERMANENT|2001-08-01 00:00:00|2001-10-01 00:00:00|61.0|212.0
-None|None|None|2001-10-01 00:00:00|2001-11-01 00:00:00|31.0|273.0
-map_4@PERMANENT|map_4|PERMANENT|2001-11-01 00:00:00|2002-01-01 00:00:00|61.0|304.0
-None|None|None|2002-01-01 00:00:00|2002-02-01 00:00:00|31.0|365.0
-map_5@PERMANENT|map_5|PERMANENT|2002-02-01 00:00:00|2002-04-01 00:00:00|59.0|396.0
-None|None|None|2002-04-01 00:00:00|2002-05-01 00:00:00|30.0|455.0
-map_6@PERMANENT|map_6|PERMANENT|2002-05-01 00:00:00|2002-07-01 00:00:00|61.0|485.0
-
-t.rast.list  method=gran input=test_strds
+<h3>Using method option</h3>
+
+Method option is able to show raster in different way. By default <em>cols</em>
+value is used, the value <em>comma</em> will print only the list of maps
+inside the space time dataset
+
+<div class="code"><pre>
+t.rast.list method=comma input=tempmean_monthly
+2009_01_tempmean@climate_2009_2012,2009_02_tempmean@climate_2009_2012,2009_03_tempmean@climate_2009_2012, \
+2009_04_tempmean@climate_2009_2012,2009_05_tempmean@climate_2009_2012,2009_06_tempmean@climate_2009_2012, \
+2009_07_tempmean@climate_2009_2012,2009_08_tempmean@climate_2009_2012,2009_09_tempmean@climate_2009_2012, \
+2009_10_tempmean@climate_2009_2012,2009_11_tempmean@climate_2009_2012,2009_12_tempmean@climate_2009_2012, \
+2010_01_tempmean@climate_2009_2012,2010_02_tempmean@climate_2009_2012,2010_03_tempmean@climate_2009_2012, \
+2010_04_tempmean@climate_2009_2012,2010_05_tempmean@climate_2009_2012,2010_06_tempmean@climate_2009_2012, \
+2010_07_tempmean@climate_2009_2012,2010_08_tempmean@climate_2009_2012,2010_09_tempmean@climate_2009_2012, \
+2010_10_tempmean@climate_2009_2012,2010_11_tempmean@climate_2009_2012,2010_12_tempmean@climate_2009_2012, \
+2011_01_tempmean@climate_2009_2012,2011_02_tempmean@climate_2009_2012,2011_03_tempmean@climate_2009_2012, \
+2011_04_tempmean@climate_2009_2012,2011_05_tempmean@climate_2009_2012,2011_06_tempmean@climate_2009_2012, \
+2011_07_tempmean@climate_2009_2012,2011_08_tempmean@climate_2009_2012,2011_09_tempmean@climate_2009_2012, \
+2011_10_tempmean@climate_2009_2012,2011_11_tempmean@climate_2009_2012,2011_12_tempmean@climate_2009_2012, \
+2012_01_tempmean@climate_2009_2012,2012_02_tempmean@climate_2009_2012,2012_03_tempmean@climate_2009_2012, \
+2012_04_tempmean@climate_2009_2012,2012_05_tempmean@climate_2009_2012,2012_06_tempmean@climate_2009_2012, \
+2012_07_tempmean@climate_2009_2012,2012_08_tempmean@climate_2009_2012,2012_09_tempmean@climate_2009_2012, \
+2012_10_tempmean@climate_2009_2012,2012_11_tempmean@climate_2009_2012,2012_12_tempmean@climate_2009_2012
+</pre></div>
+
+The <em>delta</em> value calculate the interval between maps and the
+distance from the first map.
+
+<div class="code"><pre>
+t.rast.list method=delta input=tempmean_monthly
 id|name|mapset|start_time|end_time|interval_length|distance_from_begin
-map_1@PERMANENT|map_1|PERMANENT|2001-01-01 00:00:00|2001-02-01 00:00:00|31.0|0.0
-map_1@PERMANENT|map_1|PERMANENT|2001-02-01 00:00:00|2001-03-01 00:00:00|28.0|31.0
-map_1@PERMANENT|map_1|PERMANENT|2001-03-01 00:00:00|2001-04-01 00:00:00|31.0|59.0
-None|None|None|2001-04-01 00:00:00|2001-05-01 00:00:00|30.0|90.0
-map_2@PERMANENT|map_2|PERMANENT|2001-05-01 00:00:00|2001-06-01 00:00:00|31.0|120.0
-map_2@PERMANENT|map_2|PERMANENT|2001-06-01 00:00:00|2001-07-01 00:00:00|30.0|151.0
-None|None|None|2001-07-01 00:00:00|2001-08-01 00:00:00|31.0|181.0
-map_3@PERMANENT|map_3|PERMANENT|2001-08-01 00:00:00|2001-09-01 00:00:00|31.0|212.0
-map_3@PERMANENT|map_3|PERMANENT|2001-09-01 00:00:00|2001-10-01 00:00:00|30.0|243.0
-None|None|None|2001-10-01 00:00:00|2001-11-01 00:00:00|31.0|273.0
-map_4@PERMANENT|map_4|PERMANENT|2001-11-01 00:00:00|2001-12-01 00:00:00|30.0|304.0
-map_4@PERMANENT|map_4|PERMANENT|2001-12-01 00:00:00|2002-01-01 00:00:00|31.0|334.0
-None|None|None|2002-01-01 00:00:00|2002-02-01 00:00:00|31.0|365.0
-map_5@PERMANENT|map_5|PERMANENT|2002-02-01 00:00:00|2002-03-01 00:00:00|28.0|396.0
-map_5@PERMANENT|map_5|PERMANENT|2002-03-01 00:00:00|2002-04-01 00:00:00|31.0|424.0
-None|None|None|2002-04-01 00:00:00|2002-05-01 00:00:00|30.0|455.0
-map_6@PERMANENT|map_6|PERMANENT|2002-05-01 00:00:00|2002-06-01 00:00:00|31.0|485.0
-map_6@PERMANENT|map_6|PERMANENT|2002-06-01 00:00:00|2002-07-01 00:00:00|30.0|516.0
-
-t.rast.list  method=gran input=test_strds gran="2 months"
+2009_01_tempmean@climate_2000_2012|2009_01_tempmean|climate_2000_2012|2009-01-01 00:00:00|2009-02-01 00:00:00|31.0|0.0
+2009_02_tempmean@climate_2000_2012|2009_02_tempmean|climate_2000_2012|2009-02-01 00:00:00|2009-03-01 00:00:00|28.0|31.0
+2009_03_tempmean@climate_2000_2012|2009_03_tempmean|climate_2000_2012|2009-03-01 00:00:00|2009-04-01 00:00:00|31.0|59.0
+...
+2012_10_tempmean@climate_2000_2012|2012_10_tempmean|climate_2000_2012|2012-10-01 00:00:00|2012-11-01 00:00:00|31.0|1369.0
+2012_11_tempmean@climate_2000_2012|2012_11_tempmean|climate_2000_2012|2012-11-01 00:00:00|2012-12-01 00:00:00|30.0|1400.0
+2012_12_tempmean@climate_2000_2012|2012_12_tempmean|climate_2000_2012|2012-12-01 00:00:00|2013-01-01 00:00:00|31.0|1430.0
+</pre></div>
+
+The <em>gran</em> value it is used to return data sampled by a user
+defined granule. As default the granularity of the space time raster
+dataset is used for sampling.
+
+<div class="code"><pre>
+t.rast.list  method=gran input=tempmean_monthly
 id|name|mapset|start_time|end_time|interval_length|distance_from_begin
-map_1@PERMANENT|map_1|PERMANENT|2001-01-01 00:00:00|2001-03-01 00:00:00|59.0|0.0
-map_1@PERMANENT|map_1|PERMANENT|2001-03-01 00:00:00|2001-05-01 00:00:00|61.0|59.0
-map_2@PERMANENT|map_2|PERMANENT|2001-05-01 00:00:00|2001-07-01 00:00:00|61.0|120.0
-map_3@PERMANENT|map_3|PERMANENT|2001-07-01 00:00:00|2001-09-01 00:00:00|62.0|181.0
-map_3@PERMANENT|map_3|PERMANENT|2001-09-01 00:00:00|2001-11-01 00:00:00|61.0|243.0
-map_4@PERMANENT|map_4|PERMANENT|2001-11-01 00:00:00|2002-01-01 00:00:00|61.0|304.0
-map_5@PERMANENT|map_5|PERMANENT|2002-01-01 00:00:00|2002-03-01 00:00:00|59.0|365.0
-map_5@PERMANENT|map_5|PERMANENT|2002-03-01 00:00:00|2002-05-01 00:00:00|61.0|424.0
-map_6@PERMANENT|map_6|PERMANENT|2002-05-01 00:00:00|2002-07-01 00:00:00|61.0|485.0
-
-t.rast.list  method=gran         input=test_strds gran="18 days"
+2009_01_tempmean@climate_2009_2012|2009_01_tempmean|climate_2009_2012|2009-01-01 00:00:00|2009-02-01 00:00:00|31.0|0.0
+2009_02_tempmean@climate_2009_2012|2009_02_tempmean|climate_2009_2012|2009-02-01 00:00:00|2009-03-01 00:00:00|28.0|31.0
+2009_03_tempmean@climate_2009_2012|2009_03_tempmean|climate_2009_2012|2009-03-01 00:00:00|2009-04-01 00:00:00|31.0|59.0
+2009_04_tempmean@climate_2009_2012|2009_04_tempmean|climate_2009_2012|2009-04-01 00:00:00|2009-05-01 00:00:00|30.0|90.0
+....
+2012_09_tempmean@climate_2009_2012|2012_09_tempmean|climate_2009_2012|2012-09-01 00:00:00|2012-10-01 00:00:00|30.0|1339.0
+2012_10_tempmean@climate_2009_2012|2012_10_tempmean|climate_2009_2012|2012-10-01 00:00:00|2012-11-01 00:00:00|31.0|1369.0
+2012_11_tempmean@climate_2009_2012|2012_11_tempmean|climate_2009_2012|2012-11-01 00:00:00|2012-12-01 00:00:00|30.0|1400.0
+2012_12_tempmean@climate_2009_2012|2012_12_tempmean|climate_2009_2012|2012-12-01 00:00:00|2013-01-01 00:00:00|31.0|1430.0
+</pre></div>
+
+<div class="code"><pre>
+t.rast.list  method=gran input=tempmean_monthly gran="2 months"
 id|name|mapset|start_time|end_time|interval_length|distance_from_begin
-map_1@PERMANENT|map_1|PERMANENT|2001-01-01 00:00:00|2001-01-19 00:00:00|18.0|0.0
-map_1@PERMANENT|map_1|PERMANENT|2001-01-19 00:00:00|2001-02-06 00:00:00|18.0|18.0
-map_1@PERMANENT|map_1|PERMANENT|2001-02-06 00:00:00|2001-02-24 00:00:00|18.0|36.0
-map_1@PERMANENT|map_1|PERMANENT|2001-02-24 00:00:00|2001-03-14 00:00:00|18.0|54.0
-map_1@PERMANENT|map_1|PERMANENT|2001-03-14 00:00:00|2001-04-01 00:00:00|18.0|72.0
-None|None|None|2001-04-01 00:00:00|2001-04-19 00:00:00|18.0|90.0
-map_2@PERMANENT|map_2|PERMANENT|2001-04-19 00:00:00|2001-05-07 00:00:00|18.0|108.0
-map_2@PERMANENT|map_2|PERMANENT|2001-05-07 00:00:00|2001-05-25 00:00:00|18.0|126.0
-map_2@PERMANENT|map_2|PERMANENT|2001-05-25 00:00:00|2001-06-12 00:00:00|18.0|144.0
-map_2@PERMANENT|map_2|PERMANENT|2001-06-12 00:00:00|2001-06-30 00:00:00|18.0|162.0
-map_2@PERMANENT|map_2|PERMANENT|2001-06-30 00:00:00|2001-07-18 00:00:00|18.0|180.0
-map_3@PERMANENT|map_3|PERMANENT|2001-07-18 00:00:00|2001-08-05 00:00:00|18.0|198.0
-map_3@PERMANENT|map_3|PERMANENT|2001-08-05 00:00:00|2001-08-23 00:00:00|18.0|216.0
-map_3@PERMANENT|map_3|PERMANENT|2001-08-23 00:00:00|2001-09-10 00:00:00|18.0|234.0
-map_3@PERMANENT|map_3|PERMANENT|2001-09-10 00:00:00|2001-09-28 00:00:00|18.0|252.0
-map_3@PERMANENT|map_3|PERMANENT|2001-09-28 00:00:00|2001-10-16 00:00:00|18.0|270.0
-map_4@PERMANENT|map_4|PERMANENT|2001-10-16 00:00:00|2001-11-03 00:00:00|18.0|288.0
-map_4@PERMANENT|map_4|PERMANENT|2001-11-03 00:00:00|2001-11-21 00:00:00|18.0|306.0
-map_4@PERMANENT|map_4|PERMANENT|2001-11-21 00:00:00|2001-12-09 00:00:00|18.0|324.0
-map_4@PERMANENT|map_4|PERMANENT|2001-12-09 00:00:00|2001-12-27 00:00:00|18.0|342.0
-map_4@PERMANENT|map_4|PERMANENT|2001-12-27 00:00:00|2002-01-14 00:00:00|18.0|360.0
-None|None|None|2002-01-14 00:00:00|2002-02-01 00:00:00|18.0|378.0
-map_5@PERMANENT|map_5|PERMANENT|2002-02-01 00:00:00|2002-02-19 00:00:00|18.0|396.0
-map_5@PERMANENT|map_5|PERMANENT|2002-02-19 00:00:00|2002-03-09 00:00:00|18.0|414.0
-map_5@PERMANENT|map_5|PERMANENT|2002-03-09 00:00:00|2002-03-27 00:00:00|18.0|432.0
-map_5@PERMANENT|map_5|PERMANENT|2002-03-27 00:00:00|2002-04-14 00:00:00|18.0|450.0
-map_6@PERMANENT|map_6|PERMANENT|2002-04-14 00:00:00|2002-05-02 00:00:00|18.0|468.0
-map_6@PERMANENT|map_6|PERMANENT|2002-05-02 00:00:00|2002-05-20 00:00:00|18.0|486.0
-map_6@PERMANENT|map_6|PERMANENT|2002-05-20 00:00:00|2002-06-07 00:00:00|18.0|504.0
-map_6@PERMANENT|map_6|PERMANENT|2002-06-07 00:00:00|2002-06-25 00:00:00|18.0|522.0
-map_6@PERMANENT|map_6|PERMANENT|2002-06-25 00:00:00|2002-07-13 00:00:00|18.0|540.0
+2009_01_tempmean@climate_2009_2012|2009_01_tempmean|climate_2009_2012|2009-01-01 00:00:00|2009-03-01 00:00:00|59.0|0.0
+2009_03_tempmean@climate_2009_2012|2009_03_tempmean|climate_2009_2012|2009-03-01 00:00:00|2009-05-01 00:00:00|61.0|59.0
+2009_05_tempmean@climate_2009_2012|2009_05_tempmean|climate_2009_2012|2009-05-01 00:00:00|2009-07-01 00:00:00|61.0|120.0
+....
+2012_07_tempmean@climate_2009_2012|2012_07_tempmean|climate_2009_2012|2012-07-01 00:00:00|2012-09-01 00:00:00|62.0|1277.0
+2012_09_tempmean@climate_2009_2012|2012_09_tempmean|climate_2009_2012|2012-09-01 00:00:00|2012-11-01 00:00:00|61.0|1339.0
+2012_11_tempmean@climate_2009_2012|2012_11_tempmean|climate_2009_2012|2012-11-01 00:00:00|2013-01-01 00:00:00|61.0|1400.0
 </pre></div>
 
+For the <em>deltagaps</em> value you can see the example for space time
+vector dataset <a href="t.vect.list.html#using-method-option">t.vect.list</a>
+
 <h2>SEE ALSO</h2>
 
 <em>

temporal/t.rast.mapcalc/t.rast.mapcalc.html

@@ -1,35 +1,35 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.rast.mapcalc</em> performs spatio-temporal 
-<em>mapcalc</em> expressions on maps of temporally sampled space time 
-raster datasets (STRDS). Spatial and temporal operators and internal 
-variables are available in the expression string. The description of 
-the spatial operators, functions and internal variables is available in 
-the <a href="r.mapcalc.html">r.mapcalc</a> manual page. The temporal 
+<em>t.rast.mapcalc</em> performs spatio-temporal
+<em>mapcalc</em> expressions on maps of temporally sampled space time
+raster datasets (STRDS). Spatial and temporal operators and internal
+variables are available in the expression string. The description of
+the spatial operators, functions and internal variables is available in
+the <a href="r.mapcalc.html">r.mapcalc</a> manual page. The temporal
 functions are described in detail below.
 <p>
-This module expects several parameter. All space time raster datasets 
-that are referenced in the <em>mapcalc expression</em> must be listed 
-in the <em>input</em> option. The <em>first</em> space time raster 
-dataset that is listed as input will be used to temporally sample all 
-other space time raster datasets. The temporal sampling method can be 
-chosen using the <em>method</em> option. The order of the STRDS's in 
-the mapcalc expression can be different to the order of the STRDS's in 
-the input option. The resulting space time raster dataset must be 
-specified in the <em>output</em> option together with the <em>base</em> 
-name of generated raster maps that are registered in the resulting 
-STRDS. Empty maps resulting from map-calculation are not registered by 
-default. This behavior can be changed with the <em>-n</em> flag. The 
-flag <em>-s</em> can be used to assure that only spatial related maps 
-in the STRDS's are processed. Spatial related means that temporally 
+This module expects several parameter. All space time raster datasets
+that are referenced in the <em>mapcalc expression</em> must be listed
+in the <em>input</em> option. The <em>first</em> space time raster
+dataset that is listed as input will be used to temporally sample all
+other space time raster datasets. The temporal sampling method can be
+chosen using the <em>method</em> option. The order of the STRDS's in
+the mapcalc expression can be different to the order of the STRDS's in
+the input option. The resulting space time raster dataset must be
+specified in the <em>output</em> option together with the <em>base</em>
+name of generated raster maps that are registered in the resulting
+STRDS. Empty maps resulting from map-calculation are not registered by
+default. This behavior can be changed with the <em>-n</em> flag. The
+flag <em>-s</em> can be used to assure that only spatial related maps
+in the STRDS's are processed. Spatial related means that temporally
 related maps overlap in their spatial extent.
 <p>
 The module <em>t.rast.mapcalc</em> supports parallel processing. The option
 <em>nprocs</em> specifies the number of processes that can be started in
-parallel. 
+parallel.
 <p>
-A mapcalc expression must be provided to process the temporal 
-sampled maps. Temporal internal variables are available in addition to 
+A mapcalc expression must be provided to process the temporal
+sampled maps. Temporal internal variables are available in addition to
 the <em>r.mapcalc</em> spatial operators and functions:
 <p>
 Supported internal variables for relative and absolute time:
@@ -38,23 +38,23 @@ Supported internal variables for relative and absolute time:
        represents the size of the current sample time interval
        in days and fraction of days for absolute time,
        and in relative units in case of relative time. </li>
-  <li> <em>start_time()</em> - This internal variable represent 
+  <li> <em>start_time()</em> - This internal variable represent
     the time difference between the start time of the sample space time
     raster dataset and the start time of the current sample interval or instance.
     The time is measured in days and fraction of days for absolute time,
     and in relative units in case of relative time. </li>
-  <li> <em>end_time()</em> - This internal variable represent 
+  <li> <em>end_time()</em> - This internal variable represent
     the time difference between the start time of the sample space time
     raster dataset and the end time of the current sample interval. The
     time is measured in days and fraction of days for absolute time,
-    and in relative units in case of relative time. 
+    and in relative units in case of relative time.
     The end_time() will be represented by null() in case of a time instance.</li>
 </ul>
 <p>
 Supported internal variables for absolute time of the current sample interval or instance:
 <ul>
   <li> <em>start_doy()</em> - Day of year (doy) from the start time [1 - 366] </li>
-  <li> <em>start_dow()</em> - Day of week (dow) from the start time [1 - 7], 
+  <li> <em>start_dow()</em> - Day of week (dow) from the start time [1 - 7],
          the start of the week is monday == 1 </li>
   <li> <em>start_year()</em> - The year of the start time [0 - 9999] </li>
   <li> <em>start_month()</em> - The month of the start time [1 - 12] </li>
@@ -63,9 +63,8 @@ Supported internal variables for absolute time of the current sample interval or
   <li> <em>start_hour()</em> - The hour of the start time [0 - 23] </li>
   <li> <em>start_minute()</em> - The minute of the start time [0 - 59] </li>
   <li> <em>start_second()</em> - The second of the start time [0 - 59] </li>
-       
   <li> <em>end_doy()</em> - Day of year (doy) from the end time [1 - 366] </li>
-  <li> <em>end_dow()</em> - Day of week (dow) from the end time [1 - 7], 
+  <li> <em>end_dow()</em> - Day of week (dow) from the end time [1 - 7],
          the start of the week is monday == 1 </li>
   <li> <em>end_year()</em> - The year of the end time [0 - 9999] </li>
   <li> <em>end_month()</em> - The month of the end time [1 - 12] </li>
@@ -75,20 +74,20 @@ Supported internal variables for absolute time of the current sample interval or
   <li> <em>end_minute()</em> - The minute of the end time [0 - 59] </li>
   <li> <em>end_second()</em> - The second of the end time [0 - 59] </li>
 </ul>
-The <em>end_*</em> functions are represented by the null() internal variables 
+The <em>end_*</em> functions are represented by the null() internal variables
 in case of time instances.
 
 <h2>NOTE</h2>
 
-We will discuss the internal work of <em>t.rast.mapcalc</em> with an 
-example. Imagine we have two STRDS as input, each with monthly 
-granularity. The first one <em>A</em> has 6 raster maps (a3 ... a8) 
-with a temporal range from March to August. The second STRDS <em>B</em> 
-has 12 raster maps (b1 ... b12) ranging from January to December. The 
-value of the raster maps is the number of the month from their interval 
-start time. Dataset <em>A</em> will be used to sample dataset 
-<em>B</em> to create a dataset <em>C</em>. We want to add all maps with 
-equal time stamps if the month of the start time is May or June, 
+We will discuss the internal work of <em>t.rast.mapcalc</em> with an
+example. Imagine we have two STRDS as input, each with monthly
+granularity. The first one <em>A</em> has 6 raster maps (a3 ... a8)
+with a temporal range from March to August. The second STRDS <em>B</em>
+has 12 raster maps (b1 ... b12) ranging from January to December. The
+value of the raster maps is the number of the month from their interval
+start time. Dataset <em>A</em> will be used to sample dataset
+<em>B</em> to create a dataset <em>C</em>. We want to add all maps with
+equal time stamps if the month of the start time is May or June,
 otherwise we multiply the maps. The command will look as follows:
 <p>
 <div class="code"><pre>
@@ -108,10 +107,10 @@ 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>
 <p>
-Internally the spatio-temporal expression will be analyzed for each 
-time interval of the sample dataset A, the temporal functions will be 
-replaced by numerical values, the names of the space time raster 
-datasets will be replaced by the corresponding raster maps. The final 
+Internally the spatio-temporal expression will be analyzed for each
+time interval of the sample dataset A, the temporal functions will be
+replaced by numerical values, the names of the space time raster
+datasets will be replaced by the corresponding raster maps. The final
 expression will be passed to <em>r.mapcalc</em>, resulting in 6 runs:
 <p>
 <div class="code"><pre>
@@ -126,109 +125,31 @@ r.mapcalc expr="c_6 = if(8 == 5 || 8 == 6, (a8 + b8), (a8 * b8))"
 
 <h2>EXAMPLE</h2>
 
-Here the full script to reproduce the example:
-<p>
-<div class="code"><pre>
-g.region s=0 n=80 w=0 e=120 b=0 t=50 res=10 res3=10 -p3
-# Lets create the raster maps
-r.mapcalc  expr="a3 = 3"
-r.mapcalc  expr="a4 = 4"
-r.mapcalc  expr="a5 = 5"
-r.mapcalc  expr="a6 = 6"
-r.mapcalc  expr="a7 = 7"
-r.mapcalc  expr="a8 = 8"
-
-r.mapcalc  expr="b1 = 1"
-r.mapcalc  expr="b2 = 2"
-r.mapcalc  expr="b3 = 3"
-r.mapcalc  expr="b4 = 4"
-r.mapcalc  expr="b5 = 5"
-r.mapcalc  expr="b6 = 6"
-r.mapcalc  expr="b7 = 7"
-r.mapcalc  expr="b8 = 8"
-r.mapcalc  expr="b9 = 8"
-r.mapcalc  expr="b10 = 10"
-r.mapcalc  expr="b11 = 11"
-r.mapcalc  expr="b12 = 12"
-
-t.create  type=strds temporaltype=absolute \
-    output=A title="Dataset A" descr="Dataset A"
-    
-t.create  type=strds temporaltype=absolute \
-    output=B title="Dataset B" descr="Dataset B"
-    
-t.register  -i type=rast input=A maps=a3,a4,a5,a6,a7,a8 \
-    start="2001-03-01" increment="1 months"
-    
-t.register  -i type=rast input=B maps=b1,b2,b3,b4,b5,b6,b7,b8,b9,b10,b11,b12 \
-    start="2001-01-01" increment="1 months"
-
-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.info type=strds input=C
-
- +-------------------- Space Time Raster Dataset -----------------------------+
- |                                                                            |
- +-------------------- Basic information -------------------------------------+
- | Id: ........................ C@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))"
- | 
- +----------------------------------------------------------------------------+
+The following command it is creating a new raster space time dataset where
+in the January maps are if the temperature is more than 0 it is setting
+null otherwise it set the original value. The other months are copied as
+the original one.
 
+<div class="code"><pre>
+t.rast.mapcalc input=tempmean_monthly output=january_under_0 base=january_under_0 \
+    expr="if(start_month() == 1 && tempmean_monthly > 0, null(), tempmean_monthly)"
 
-t.rast.list input=C columns=name,start_time,min,max
-
+# printing the minimum or maximum values only for January
+t.rast.list january_under_0 columns=name,start_time,min,max | grep 01-01
 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
+january_under_0_01|2009-01-01 00:00:00|-3.380823|-7e-06
+january_under_0_13|2010-01-01 00:00:00|-5.266929|-0.000154
+january_under_0_25|2011-01-01 00:00:00|-4.968747|-6.1e-05
+january_under_0_37|2012-01-01 00:00:00|-0.534994|-0.014581
+
+# these are the original data, you can see that the maximum is different
+t.rast.list tempmean_monthly columns=name,start_time,min,max | grep 01-01
+2009_01_tempmean|2009-01-01 00:00:00|-3.380823|7.426054
+2010_01_tempmean|2010-01-01 00:00:00|-5.266929|5.71131
+2011_01_tempmean|2011-01-01 00:00:00|-4.968747|4.967295
+2012_01_tempmean|2012-01-01 00:00:00|-0.534994|9.69511
 </pre></div>
 
-
 <h2>SEE ALSO</h2>
 
 <em>

temporal/t.rast.neighbors/t.rast.neighbors.html

@@ -1,187 +1,103 @@
 <h2>DESCRIPTION</h2>
 
 <em>t.rast.neighbors</em> performs <a href="r.neighbors.html">r.neighbors</a>
-computations on the maps of a space time raster dataset (STRDS). This 
+computations on the maps of a space time raster dataset (STRDS). This
 module supports a subset of options that are available in
-<a href="r.neighbors.html">r.neighbors</a>. The size of the neighborhood 
+<a href="r.neighbors.html">r.neighbors</a>. The size of the neighborhood
 and the aggregation method can be chosen.
 <p>
 The user must provide an input and an output space time raster dataset and
 the basename  of the resulting raster maps. The resulting STRDS will have
-the same temporal resolution as the input dataset. 
+the same temporal resolution as the input dataset.
 All maps will be processed using the current region settings.
 <p>
-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> 
+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 multi-core system.
 
 
 <h2>EXAMPLE</h2>
 
-In this example we create 7 raster maps that will be registered in a 
-single space time raster dataset named <em>precipitation_daily</em> 
-using a daily temporal granularity. The names of the raster maps are 
-stored in a text file that is used for raster map registration. 
-<p>
-A neighborhood average smoothing with a window size of 5 cells will be 
-performed on the space time raster dataset <em>precipitation_daily</em> 
-resulting in the output space time raster dataset 
-<em>precipitation_daily_smooth</em>. The base name of the new generated 
-raster maps is <em>prec_smooth</em>. The temporal resolution of the 
-resulting STRDS is identical to the input STRDS.
-
+To smooth the maps contained into a space time dataset run:
 
 <div class="code"><pre>
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
-
-count=1
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = rand(0, 550)" seed=${count}
-    echo ${map} >> map_list.txt 
-    count=$((count+1))
-done
-
-t.create --o type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
-
-t.register -i --o type=rast input=precipitation_daily \
-           file=map_list.txt start="2012-08-20" increment="1 days"
-
-t.info type=strds input=precipitation_daily
+t.rast.neighbors input=tempmean_monthly output=smooth_tempmean_monthly \
+                 base=tmean_smooth size=5 method=average nprocs=4
 
+# show some info about the new space time dataset
+t.info smooth_tempmean_monthly
  +-------------------- Space Time Raster Dataset -----------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@PERMANENT
- | Name: ...................... precipitation_daily
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
+ | Id: ........................ smooth_tempmean_monthly@climate_2000_2012
+ | Name: ...................... smooth_tempmean_monthly
+ | Mapset: .................... climate_2000_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-11-23 17:08:11.135848
- | Modification time:.......... 2014-11-23 17:08:11.647709
+ | Creation time: ............. 2014-11-27 11:41:36.444579
+ | Modification time:.......... 2014-11-27 11:41:39.978232
  | Semantic type:.............. mean
  +-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-08-20 00:00:00
- | End time:................... 2012-08-27 00:00:00
- | Granularity:................ 1 day
+ | Start time:................. 2009-01-01 00:00:00
+ | End time:................... 2013-01-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
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
  | Top:........................ 0.0
  | Bottom:..................... 0.0
  +-------------------- Metadata information ----------------------------------+
- | 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
- | East-west resolution max:... 10.0
- | Minimum value min:.......... 0.0
- | Minimum value max:.......... 8.0
- | Maximum value min:.......... 533.0
- | Maximum value max:.......... 549.0
+ | Raster register table:...... raster_map_register_ea1c9a83524e41a784d72744b08c6107
+ | North-South resolution min:. 500.0
+ | North-South resolution max:. 500.0
+ | East-west resolution min:... 500.0
+ | East-west resolution max:... 500.0
+ | Minimum value min:.......... -6.428905
+ | Minimum value max:.......... 18.867296
+ | Maximum value min:.......... 4.247691
+ | Maximum value max:.......... 28.767953
  | Aggregation type:........... None
- | Number of registered maps:.. 7
+ | Number of registered maps:.. 48
  |
  | Title:
- | Daily precipitation
+ | Monthly precipitation
  | Description:
- | Test dataset with daily precipitation
+ | Dataset with monthly 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
-
-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 \
-    output=precipitation_daily_smooth base=prec_smooth \
-    size=5 method=average nprocs=3
-    
-t.info type=strds input=precipitation_daily_smooth
-
- +-------------------- Space Time Raster Dataset -----------------------------+
- |                                                                            |
- +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily_smooth@PERMANENT
- | Name: ...................... precipitation_daily_smooth
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
- | 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 day
- | 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_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
+ | # 2014-11-27 11:41:36
+ | t.rast.neighbors input="tempmean_monthly"
+ |     output="smooth_tempmean_monthly" base="tmean_smooth" size="5"
+ |     method="average" nprocs="4"
  |
- | Title:
- | Daily precipitation
- | Description:
- | Test dataset with daily precipitation
- | 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
+# new now compare the values between original data and the smoothed one
+t.rast.list input=smooth_tempmean_monthly columns=name,start_time,min,max
 
+t.rast.list input=smooth_tempmean_monthly columns=name,start_time,min,max
+name|start_time|min|max
+tmean_smooth_1|2009-01-01 00:00:00|-3.361714|7.409861
+tmean_smooth_2|2009-02-01 00:00:00|-1.820261|7.986794
+tmean_smooth_3|2009-03-01 00:00:00|2.912971|11.799684
+...
+tmean_smooth_46|2012-10-01 00:00:00|9.38767|18.709297
+tmean_smooth_47|2012-11-01 00:00:00|1.785653|10.911189
+tmean_smooth_48|2012-12-01 00:00:00|1.784212|11.983857
+
+t.rast.list input=tempmean_monthly columns=name,start_time,min,max
 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
+2009_01_tempmean|2009-01-01 00:00:00|-3.380823|7.426054
+2009_02_tempmean|2009-02-01 00:00:00|-1.820261|8.006386
+2009_03_tempmean|2009-03-01 00:00:00|2.656992|11.819274
+...
+2012_10_tempmean|2012-10-01 00:00:00|9.070884|18.709297
+2012_11_tempmean|2012-11-01 00:00:00|1.785653|10.911189
+2012_12_tempmean|2012-12-01 00:00:00|1.761019|11.983857
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.rast.out.vtk/t.rast.out.vtk.html

@@ -15,40 +15,22 @@ are exported using <b>t.rast.out.vtk</b> into the directoy
 
 
 <div class="code"><pre>
-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
+mkdir /tmp/export
+t.rast.out.vtk input=precip_abs expdir=/tmp/export elevation=elevation
+
+ls -1 /tmp/export
+000000_tempmean_monthly.vtk
+000001_tempmean_monthly.vtk
+000002_tempmean_monthly.vtk
+000003_tempmean_monthly.vtk
+000004_tempmean_monthly.vtk
+000005_tempmean_monthly.vtk
+000006_tempmean_monthly.vtk
+000007_tempmean_monthly.vtk
+000008_tempmean_monthly.vtk
+000009_tempmean_monthly.vtk
+000010_tempmean_monthly.vtk
+000011_tempmean_monthly.vtk
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.rast.series/t.rast.series.html

@@ -1,36 +1,36 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.rast.series</em> is a simple wrapper for the raster module 
-<b>r.series</b>. It supports a subset of the aggregation methods of 
+<em>t.rast.series</em> 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 
+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 with complex <b>where</b> statements 
+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 \
+t.rast.series input=tempmean_monthly \
     output=jan_average method=average \
     where="start_time = datetime(start_time, 'start of year', '0 month')"
 
 # February averages
-t.rast.series input=monthly_aggregates \
+t.rast.series input=tempmean_monthly \
     output=feb_average method=average \
     where="start_time = datetime(start_time, 'start of year', '1 month')"
 
 # March averages
-t.rast.series input=monthly_aggregates \
+t.rast.series input=tempmean_monthly \
     output=mar_average method=average \
     where="start_time = datetime(start_time, 'start of year', '2 month')"
 </pre></div>

temporal/t.rast.to.rast3/t.rast.to.rast3.html

@@ -1,14 +1,14 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.rast.to.rast3</em> 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) 
+<em>t.rast.to.rast3</em> 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 
+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
@@ -17,167 +17,96 @@ 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 
+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 
+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>
-
-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.
+To create a voxel map layer from a subset of the <em>tempmean_monthly</em>
+space time dataset, run:
 
 <div class="code"><pre>
-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"
+# create the subset for 2012 data
+t.rast.extract input=tempmean_monthly output=tempmean_monthly_later_2012 \
+               where="start_time >= '2012-01-01'"
 
-t.register -i type=rast input=A file=${n1}
+# set the right 3D region
+g.region -p3 res3=500
 
-t.info type=strds input=A
-
- +-------------------- Space Time Raster Dataset -----------------------------+
- |                                                                            |
- +-------------------- Basic information -------------------------------------+
- | Id: ........................ A@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=3draster input=cube
+# convert to 3D raster map
+t.rast.to.rast3 in=tempmean_monthly_later_2012@climate_2009_2012 out=tempmean_monthly_2012
 
+t.info type=rast3d input=tempmean_monthly_2012
  +-------------------- 3D Raster Dataset -------------------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ cube@PERMANENT
- | Name: ...................... cube
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
+ | Id: ........................ tempmean_monthly_2012@climate_2009_2012
+ | Name: ...................... tempmean_monthly_2012
+ | Mapset: .................... climate_2009_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-11-23 16:28:46.341227
+ | Creation time: ............. 2014-11-28 11:10:51.679294
  +-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2001-01-01 00:00:00
- | End time:................... 2001-10-01 00:00:00
+ | Start time:................. 2012-01-01 00:00:00
+ | End time:................... 2013-01-01 00:00:00
  +-------------------- Spatial extent ----------------------------------------+
- | North:...................... 80.0
- | South:...................... 0.0
- | East:.. .................... 120.0
- | West:....................... 0.0
- | Top:........................ 1222.0
- | Bottom:..................... 1213.0
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
+ | Top:........................ 1357.0
+ | Bottom:..................... 1345.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
+ | Number of columns:.......... 620
+ | Number of rows:............. 1630
+ | Number of cells:............ 12127200
+ | North-South resolution:..... 500.0
+ | East-west resolution:....... 500.0
+ | Minimum value:.............. -0.534994
+ | Maximum value:.............. 28.794653
+ | Number of depths:........... 12
  | Top-Bottom resolution:...... 1.0
- | Registered datasets ........ 
+ | Registered datasets ........
  +----------------------------------------------------------------------------+
 
 
-r3.info cube
-
+r3.info tempmean_monthly_2012
  +----------------------------------------------------------------------------+
- | Layer:    cube                           Date: Sun Nov 23 16:28:46 2014    |
- | Mapset:   PERMANENT                      Login of Creator: soeren          |
- | Location: LL                                                               |
- | DataBase: /home/soeren/grassdata                                           |
+ | Layer:    tempmean_monthly_2012          Date: Fri Nov 28 11:10:50 2014    |
+ | Mapset:   climate_2009_2012              Login of Creator: lucadelu        |
+ | Location: nc_spm_temporal_workshop                                         |
+ | DataBase: /grassdata                                                       |
  | Title:    Space time voxel cube                                            |
  | Units:    none                                                             |
  | Vertical unit: months                                                      |
- | Timestamp: 1 Jan 2001 00:00:00 / 1 Oct 2001 00:00:00                       |
+ | Timestamp: none                                                            |
  |----------------------------------------------------------------------------|
  |                                                                            |
  |   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                               |
+ |   Rows:         620                                                        |
+ |   Columns:      1630                                                       |
+ |   Depths:       12                                                         |
+ |   Total Cells:  12127200                                                   |
+ |   Total size:           28414287 Bytes                                     |
+ |   Number of tiles:      4230                                               |
+ |   Mean tile size:       6717 Bytes                                         |
+ |   Tile size in memory:  23520 Bytes                                        |
+ |   Number of tiles in x, y and  z:   47, 45, 2                              |
+ |   Dimension of a tile in x, y, z:   35, 14, 6                              |
  |                                                                            |
- |        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                       |
+ |        Projection: Lambert Conformal Conic (zone 0)                        |
+ |            N:     320000    S:      10000   Res:   500                     |
+ |            E:     935000    W:     120000   Res:   500                     |
+ |            T:       1357    B:       1345   Res:     1                     |
+ |   Range of data:   min = -0.53499434 max = 28.79465315                     |
  |                                                                            |
  |   Data Source:                                                             |
  |                                                                            |
@@ -187,9 +116,14 @@ r3.info cube
  |    This space time voxel cube was created with t.rast.to.rast3             |
  |                                                                            |
  |   Comments:                                                                |
- |    r.to.rast3 input="a1@PERMANENT,a1@PERMANENT,a1@PERMANENT,temporary_n\   |
- |    ull_map_22842,a2@PERMANENT,a2@PERMANENT,temporary_null_map_22842,a3@\   |
- |    PERMANENT,a3@PERMANENT" output="cube" tilesize=32                       |
+ |    r.to.rast3 input="2012_01_tempmean@climate_2009_2012,2012_02_tempmea\   |
+ |    n@climate_2009_2012,2012_03_tempmean@climate_2009_2012,2012_04_tempm\   |
+ |    ean@climate_2009_2012,2012_05_tempmean@climate_2009_2012,2012_06_tem\   |
+ |    pmean@climate_2009_2012,2012_07_tempmean@climate_2009_2012,2012_08_t\   |
+ |    empmean@climate_2009_2012,2012_09_tempmean@climate_2009_2012,2012_10\   |
+ |    _tempmean@climate_2009_2012,2012_11_tempmean@climate_2009_2012,2012_\   |
+ |    12_tempmean@climate_2009_2012" output="tempmean_monthly_2012" tilesi\   |
+ |    ze=32                                                                   |
  |                                                                            |
  +----------------------------------------------------------------------------+
 </pre></div>

temporal/t.rast.univar/t.rast.univar.html

@@ -1,97 +1,29 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.rast.univar</em> calculates univariate statistics from the 
-non-null cells for each registered raster map of a space time raster 
+<em>t.rast.univar</em> calculates univariate statistics from the
+non-null cells for each registered raster map of a space time raster
 dataset.
 <p>
-By default it returns the name of the map, the start and end date of 
-dataset and the following values: mean, minimum and maximum vale, 
-mean_of_abs, standard deviation, variance,coeff_var, number of null 
+By default it returns the name of the map, the start and end date of
+dataset and the following values: mean, minimum and maximum vale,
+mean_of_abs, standard deviation, variance,coeff_var, number of null
 cells, total number of cell.
 <p>
-Using the <em>e</em> flag it can calculate also extended statistics: 
+Using the <em>e</em> flag it can calculate also extended statistics:
 first quartile, median value, third quartile and percentile 90.
 
-<div class="code"><pre>
-MAPS="map_1 map_2 map_3 map_4 map_5 map_6 map_7"
-maxn=10
-
-for map in ${MAPS} ; do
-    r.mapcalc --o expr="${map} = rand(0,$maxn)" -s
-    echo ${map} >> map_list.txt 
-    maxn=`expr $maxn + 10`
-done
-
-t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
+<h2>EXAMPLE</h2>
 
-t.register -i type=rast input=precipitation_daily \
-           file=map_list.txt start="2012-08-20" increment="1 day"
+Obtain the univariate statistics for the raster space time dataset.
 
-t.info type=strds input=precipitation_daily
- +-------------------- Space Time Raster Dataset -----------------------------+
- |                                                                            |
- +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@PERMANENT
- | Name: ...................... precipitation_daily
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
- | Temporal type: ............. absolute
- | Creation time: ............. 2014-06-29 23:08:48.165581
- | Modification time:.......... 2014-06-29 23:08:52.729316
- | Semantic type:.............. mean
- +-------------------- Absolute time -----------------------------------------+
- | 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:...................... 0.0
- | East:.. .................... 120.0
- | West:....................... 0.0
- | Top:........................ 0.0
- | Bottom:..................... 0.0
- +-------------------- Metadata information ----------------------------------+
- | Raster register table:...... raster_map_register_3446b4c32e4f4f9fbcc3d0757995b9ec
- | 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:.......... 69.0
- | Aggregation type:........... None
- | Number of registered maps:.. 7
- |
- | Title:
- | Daily precipitation
- | Description:
- | Test dataset with daily precipitation
- | Command history:
- | # 2014-06-29 23:08:48 
- | t.create type="strds" temporaltype="absolute"
- |     output="precipitation_daily" title="Daily precipitation"
- |     description="Test dataset with daily precipitation"
- | # 2014-06-29 23:08:52 
- | t.register -i type="rast" input="precipitation_daily"
- |     file="map_list.txt" start="2012-08-20" increment="1 day"
- | 
- +----------------------------------------------------------------------------+
-
- 
-t.rast.univar -e precipitation_daily
+<div class="code"><pre>
+t.rast.univar -e tempmean_monthly
 id|start|end|mean|min|max|mean_of_abs|stddev|variance|coeff_var|sum|null_cells|cells|first_quartile|median|third_quartile|percentile_90
-map_1@PERMANENT|2012-08-27 00:00:00|2012-08-28 00:00:00|4.16666666666667|0|9|4.16666666666667|3.01270458042087|9.07638888888889|72.3049099301009|400|0|96|2|3|7|9
-map_2@PERMANENT|2012-08-28 00:00:00|2012-08-29 00:00:00|9.58333333333333|0|19|9.58333333333333|6.0736223860962|36.8888888888889|63.3769292462212|920|0|96|3|11|14|18
-map_3@PERMANENT|2012-08-29 00:00:00|2012-08-30 00:00:00|14.4791666666667|0|29|14.4791666666667|8.78680256438914|77.2078993055555|60.6858306605293|1390|0|96|8|13|22|26
-map_4@PERMANENT|2012-08-30 00:00:00|2012-08-31 00:00:00|19.1666666666667|0|39|19.1666666666667|11.7132996584604|137.201388888889|61.1128677832717|1840|0|96|9|19|30|35
-map_5@PERMANENT|2012-08-31 00:00:00|2012-09-01 00:00:00|24.7916666666667|0|48|24.7916666666667|14.2937316292454|204.310763888889|57.655388084351|2380|0|96|13|22.5|39|44
-map_6@PERMANENT|2012-09-01 00:00:00|2012-09-02 00:00:00|31.0416666666667|0|59|31.0416666666667|17.2885539367011|298.894097222222|55.6946704001108|2980|0|96|17|33|44|54
-map_7@PERMANENT|2012-09-02 00:00:00|2012-09-03 00:00:00|34.7916666666667|0|69|34.7916666666667|20.8401238933191|434.310763888889|59.8997572981626|3340|0|96|14|36|52|62
+2009_01_tempmean@climate_2009_2012|2009-01-01 00:00:00|2009-02-01 00:00:00|3.89849421589013|-3.38082313537598|7.42605421278212|3.94753539201851|1.78991938025743|3.20381138782113|45.9130957014576|1977967.31483353|503233|1010600|2.79614|3.92288|5.21245|6.22511
+2009_02_tempmean@climate_2009_2012|2009-02-01 00:00:00|2009-03-01 00:00:00|5.91200374639234|-1.82026121351454|8.00638622707791|5.91619095651249|1.62749663159835|2.64874528586399|27.5286806540252|2999555.60479584|503233|1010600|5.43935|6.25721|7.06546|7.4834
+...
+2012_11_tempmean@climate_2009_2012|2012-11-01 00:00:00|2012-12-01 00:00:00|8.02668042229112|1.78565343221029|10.9111891852485|8.02668042229112|1.31691138968006|1.73425560826908|16.4066752430162|4072472.76581658|503233|1010600|7.4863|8.13301|8.96423|9.48106
+2012_12_tempmean@climate_2009_2012|2012-12-01 00:00:00|2013-01-01 00:00:00|8.70849654378088|1.76101896497938|11.9838566250271|8.70849654378088|1.71871196592494|2.95397082181358|19.7360354601317|4418403.76592848|503233|1010600|7.83597|8.95478|9.99429|10.6702
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.register/t.register.html

@@ -1,39 +1,39 @@
 <h2>DESCRIPTION</h2>
 
-The module <em>t.register</em> is designed to register raster, 3D 
-raster and vector maps in the temporal database and in specific space 
-time datasets. This module must be used to assign time stamps to 
+The module <em>t.register</em> is designed to register raster, 3D
+raster and vector maps in the temporal database and in specific space
+time datasets. This module must be used to assign time stamps to
 raster, 3D raster and vector maps. The existing timestamp modules
 <a href="r.timestamp.html">r.timestamp</a>,
 <a href="r3.timestamp.html">r3.timestamp</a> and
-<a href="v.timestamp.html">v.timestamp</a> do not register the maps in the 
-temporal database of GRASS. However, timestamps that have been created 
-with these modules can be read and used by <em>t.register</em>. This 
-works only for maps that are not already registered in the temporal 
+<a href="v.timestamp.html">v.timestamp</a> do not register the maps in the
+temporal database of GRASS. However, timestamps that have been created
+with these modules can be read and used by <em>t.register</em>. This
+works only for maps that are not already registered in the temporal
 database.
 <p>
-This module supports absolute and relative time. Maps can be registered 
-by command line argument (a list of comma separated map names) or using 
-an input file. The start time, the end time and a temporal increment 
-can be provided by command line or in the input file. End time and 
-increment are mutual exclusive. The user can register single maps or a 
-list of maps at once. Maps can be registered in several space time 
+This module supports absolute and relative time. Maps can be registered
+by command line argument (a list of comma separated map names) or using
+an input file. The start time, the end time and a temporal increment
+can be provided by command line or in the input file. End time and
+increment are mutual exclusive. The user can register single maps or a
+list of maps at once. Maps can be registered in several space time
 datasets using the same timestamp.
 <p>
-Start time and end time with absolute time must be provided using the 
-format <b>yyyy-mm-dd HH:MM:SS +HHMM</b>. It is supported to specify 
-only the date <b>yyyy-mm-dd</b>. In case of relative time the temporal 
-unit (years, months, days, hours, minutes or seconds) must be provided. 
+Start time and end time with absolute time must be provided using the
+format <b>yyyy-mm-dd HH:MM:SS +HHMM</b>. It is supported to specify
+only the date <b>yyyy-mm-dd</b>. In case of relative time the temporal
+unit (years, months, days, hours, minutes or seconds) must be provided.
 The relative start time, end time and the increment are integers.
 
 <h2>Note</h2>
 
-The timestamps of registered maps will be stored in the temporal 
-database and in the metadata of the grass maps in the spatial database. 
-This assures that timestamps can always be accessed with 
-<em>(r|r3|v).timestamp</em> and the temporal modules. Timestamps should 
-only be modified with <em>t.register</em> because the 
-<em>(r|r3|v).timestamp</em> modules have no access to the temporal 
+The timestamps of registered maps will be stored in the temporal
+database and in the metadata of the grass maps in the spatial database.
+This assures that timestamps can always be accessed with
+<em>(r|r3|v).timestamp</em> and the temporal modules. Timestamps should
+only be modified with <em>t.register</em> because the
+<em>(r|r3|v).timestamp</em> modules have no access to the temporal
 database.
 
 <h2>INPUT FILE FORMAT</h2>
@@ -79,12 +79,19 @@ prec_6|2002-04-01|2002-07-01
 
 <h2>EXAMPLE</h2>
 
-In this example we create 6 raster maps that will be registered in a 
-single space time raster dataset named <em>precip_abs</em> using a 
-monthly temporal granularity. The -i flag generates interval time. The 
-generated timestamps will be inspected using <em>r.timestamp</em> and 
-t.rast.list. We will register an additional map with a timetsamp that 
-was set with <em>r.timestamp</em>.
+<h3>North Carolina dataset</h3>
+
+Register maps in a absolute space time dataset, creating a time interval
+
+<div class="code"><pre>
+t.register -i type=rast input=precipitation_monthly \
+    maps=`g.list rast patt=*precip* sep=,` start=2009-01-01 \
+    increment="1 months"
+</pre></div>
+
+<h3>Synthetic maps</h3>
+
+In this example we create 6 raster maps that will be registered in a single space time raster dataset named precip_abs using a monthly temporal granularity. The -i flag generates interval time. The generated timestamps will be inspected using r.timestamp and t.rast.list. We will register an additional map with a timetsamp that was set with r.timestamp.
 
 <div class="code"><pre>
 r.mapcalc expr="prec_1 = 100"
@@ -135,7 +142,6 @@ prec_6|PERMANENT|2001-06-01 00:00:00|2001-07-01 00:00:00
 prec_7|PERMANENT|2001-07-01 00:00:00|2001-08-01 00:00:00
 </pre></div>
 
-
 <h2>SEE ALSO</h2>
 
 <em>

temporal/t.remove/t.remove.html

@@ -1,25 +1,25 @@
 <h2>DESCRIPTION</h2>
 
-The module <em>t.remove</em> removes space time datasets (strds, str3ds, 
-stvds) from the temporal database. In other words, it deletes the relevant 
+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 
+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.
+In this example a space time raster dataset (STRDS) named
+<b>precip_months_sum</b> 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 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
+#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 \
@@ -36,10 +36,10 @@ t.rast.aggregate input=precip_months_sum \
   years" method=sum
 
 #Remove all newly produced data:
-# a) the aggregated strds with 1 years granularity together with its raster maps
+# 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
+# b) the STRDS with 1 months granularity, but not the original sample data
 t.remove type=strds input=precip_months_sum
 </pre></div>
 

temporal/t.rename/t.rename.html

@@ -1,11 +1,25 @@
 <h2>DESCRIPTION</h2>
 
-This module renames space time datasets of different types (strds, stvds, str3ds) 
+This module renames space time datasets of different types (STRDS, STVDS, STR3DS)
 and updates the space time dataset register entries of the registered maps.
 
 <h2>NOTE</h2>
 
-Renaming of space time datasets works only for sqlite3 based temporal databases.
+Renaming of space time datasets works only for SQLite based temporal databases.
+
+<h2>EXAMPLE</h2>
+
+A new vector space time dataset will be created, renamed and in the end removed
+
+<div class="code"><pre>
+#Create new and empty STVDS
+t.create type=stvds output=toberenamed semantictype=mean \
+  title="Example to rename" \
+  description="This is an example just to show how rename"
+
+t.rename input=toberenamed output=newname type=stvds
+
+t.remove input=newname type=stvds
 
 <h2>SEE ALSO</h2>
 

temporal/t.snap/t.snap.html

@@ -1,175 +1,188 @@
 <h2>DESCRIPTION</h2>
 
-<em>t.snap</em> is designed to convert time instances of maps into time 
-intervals or to create valid temporal topologies for space time 
-datasets. Raster, 3D raster and vector space time datasets are 
+<em>t.snap</em> is designed to convert time instances of maps into time
+intervals or to create valid temporal topologies for space time
+datasets. Raster, 3D raster and vector space time datasets are
 supported with absolute and relative time.
 <p>
-This module "snaps" the end time of each registered map of a space time 
-dataset to the start time of the map that is the temporal nearest 
-neighbour in the future. Maps with equal time stamps are not modified 
-and must be removed or modified to create a valid temporal topology. In 
-case the last map in the space time dataset is a time instance, the 
-granularity of the space time dataset will be used to create the time 
+This module "snaps" the end time of each registered map of a space time
+dataset to the start time of the map that is the temporal nearest
+neighbour in the future. Maps with equal time stamps are not modified
+and must be removed or modified to create a valid temporal topology. In
+case the last map in the space time dataset is a time instance, the
+granularity of the space time dataset will be used to create the time
 interval.
 
 <h2>EXAMPLE</h2>
 
-We create 6 raster maps and register them using absolute time 
-in a space time raster dataset using an increment of one month.
-Then we snap the created time instances resulting in time intervals.
+A raster space time dataset will be create using precipitation maps for 2012
+then using absolute time in a space time raster dataset using an increment
+of one month.
+At the end we snap the created time instances resulting in time intervals.
 
 <div class="code"><pre>
 # Generate data
-r.mapcalc expr="prec_1 = rand(0, 550)" -s
-r.mapcalc expr="prec_2 = rand(0, 450)" -s
-r.mapcalc expr="prec_3 = rand(0, 320)" -s
-r.mapcalc expr="prec_4 = rand(0, 510)" -s
-r.mapcalc expr="prec_5 = rand(0, 300)" -s
-r.mapcalc expr="prec_6 = rand(0, 650)" -s
 
 t.create type=strds temporaltype=absolute \
-         output=precipitation_daily \
-         title="Daily precipitation" \
-         description="Test dataset with daily precipitation"
+         output=precipitation_monthly \
+         title="Monthly precipitation" \
+         description="Dataset with monthly precipitation"
 
-t.register type=rast input=precipitation_daily \
-           maps=prec_1,prec_2,prec_3,prec_4,prec_5,prec_6 \
-           start=2012-01-01 increment="1 day"
+t.register type=rast input=precipitation_monthly \
+           maps=`g.list type=rast patt=2012*precip sep=,` \
+           start=2012-01-01 increment="1 months"
 
-t.info type=strds input=precipitation_daily
+# please take attention to "Temporal type of maps" value
+t.info type=strds input=precipitation_monthly
 
  +-------------------- Space Time Raster Dataset -----------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@PERMANENT
- | Name: ...................... precipitation_daily
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
+ | Id: ........................ precipitation_monthly@climate_2009_2012
+ | Name: ...................... precipitation_monthly
+ | Mapset: .................... climate_2009_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-11-23 19:22:22.657317
- | Modification time:.......... 2014-11-23 19:22:23.149603
+ | Creation time: ............. 2014-11-28 15:52:30.801148
+ | Modification time:.......... 2014-11-28 15:53:18.430773
  | Semantic type:.............. mean
  +-------------------- Absolute time -----------------------------------------+
  | Start time:................. 2012-01-01 00:00:00
- | End time:................... 2012-01-06 00:00:00
- | Granularity:................ 1 day
+ | End time:................... 2012-12-01 00:00:00
+ | Granularity:................ 1 month
  | Temporal type of maps:...... point
  +-------------------- Spatial extent ----------------------------------------+
- | North:...................... 80.0
- | South:...................... 0.0
- | East:.. .................... 120.0
- | West:....................... 0.0
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
  | Top:........................ 0.0
  | Bottom:..................... 0.0
  +-------------------- Metadata information ----------------------------------+
- | Raster register table:...... raster_map_register_4483cba5e46944bd9933e5392a9fd734
- | 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:.......... 25.0
- | Maximum value min:.......... 294.0
- | Maximum value max:.......... 642.0
+ | Raster register table:...... raster_map_register_282454f66ff5455299526ec3c1db7362
+ | North-South resolution min:. 500.0
+ | North-South resolution max:. 500.0
+ | East-west resolution min:... 500.0
+ | East-west resolution max:... 500.0
+ | Minimum value min:.......... 0.0
+ | Minimum value max:.......... 95.58169
+ | Maximum value min:.......... 132.413284
+ | Maximum value max:.......... 356.502949
  | Aggregation type:........... None
- | Number of registered maps:.. 6
+ | Number of registered maps:.. 12
  |
  | Title:
- | Daily precipitation
+ | Monthly precipitation
  | Description:
- | Test dataset with daily precipitation
+ | Dataset with monthly precipitation
  | Command history:
- | # 2014-11-23 19:22:22 
+ | # 2014-11-28 15:52:30
  | t.create type="strds" temporaltype="absolute"
- |     output="precipitation_daily" title="Daily precipitation"
- |     description="Test dataset with daily precipitation"
- | # 2014-11-23 19:22:23 
- | t.register type="rast" input="precipitation_daily"
- |     maps="prec_1,prec_2,prec_3,prec_4,prec_5,prec_6" start="2012-01-01"
- |     increment="1 day"
- | 
+ |     output="precipitation_monthly" title="Monthly precipitation"
+ |     description="Dataset with monthly precipitation"
+ | # 2014-11-28 15:53:18
+ | t.register type="rast" input="precipitation_monthly"
+ |     maps="2012_01_precip,2012_02_precip, ... ,2012_11_precip,2012_12_precip"
+ |     start="2012-01-01" increment="1 months"
+ |
  +----------------------------------------------------------------------------+
 
 
-t.rast.list input=precipitation_daily
+# you can see that end time is not set
+t.rast.list input=precipitation_monthly
 
 name|mapset|start_time|end_time
-prec_1|PERMANENT|2012-01-01 00:00:00|None
-prec_2|PERMANENT|2012-01-02 00:00:00|None
-prec_3|PERMANENT|2012-01-03 00:00:00|None
-prec_4|PERMANENT|2012-01-04 00:00:00|None
-prec_5|PERMANENT|2012-01-05 00:00:00|None
-prec_6|PERMANENT|2012-01-06 00:00:00|None
+2012_01_precip|climate_2009_2012|2012-01-01 00:00:00|None
+2012_02_precip|climate_2009_2012|2012-02-01 00:00:00|None
+2012_03_precip|climate_2009_2012|2012-03-01 00:00:00|None
+2012_04_precip|climate_2009_2012|2012-04-01 00:00:00|None
+2012_05_precip|climate_2009_2012|2012-05-01 00:00:00|None
+2012_06_precip|climate_2009_2012|2012-06-01 00:00:00|None
+2012_07_precip|climate_2009_2012|2012-07-01 00:00:00|None
+2012_08_precip|climate_2009_2012|2012-08-01 00:00:00|None
+2012_09_precip|climate_2009_2012|2012-09-01 00:00:00|None
+2012_10_precip|climate_2009_2012|2012-10-01 00:00:00|None
+2012_11_precip|climate_2009_2012|2012-11-01 00:00:00|None
+2012_12_precip|climate_2009_2012|2012-12-01 00:00:00|None
 
 
-t.snap type=strds input=precipitation_daily
 
-t.info type=strds input=precipitation_daily
+t.snap type=strds input=precipitation_monthly
+
+# please take attention to "Temporal type of maps" value again
+t.info type=strds input=precipitation_monthly
 
  +-------------------- Space Time Raster Dataset -----------------------------+
  |                                                                            |
  +-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_daily@PERMANENT
- | Name: ...................... precipitation_daily
- | Mapset: .................... PERMANENT
- | Creator: ................... soeren
+ | Id: ........................ precipitation_monthly@climate_2009_2012
+ | Name: ...................... precipitation_monthly
+ | Mapset: .................... climate_2009_2012
+ | Creator: ................... lucadelu
  | Temporal type: ............. absolute
- | Creation time: ............. 2014-11-23 19:22:22.657317
- | Modification time:.......... 2014-11-23 19:23:12.517443
+ | Creation time: ............. 2014-11-28 15:52:30.801148
+ | Modification time:.......... 2014-11-28 15:54:28.739905
  | Semantic type:.............. mean
  +-------------------- Absolute time -----------------------------------------+
  | Start time:................. 2012-01-01 00:00:00
- | End time:................... 2012-01-07 00:00:00
- | Granularity:................ 1 day
+ | End time:................... 2013-01-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
+ | North:...................... 320000.0
+ | South:...................... 10000.0
+ | East:.. .................... 935000.0
+ | West:....................... 120000.0
  | Top:........................ 0.0
  | Bottom:..................... 0.0
  +-------------------- Metadata information ----------------------------------+
- | Raster register table:...... raster_map_register_4483cba5e46944bd9933e5392a9fd734
- | 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:.......... 25.0
- | Maximum value min:.......... 294.0
- | Maximum value max:.......... 642.0
+ | Raster register table:...... raster_map_register_282454f66ff5455299526ec3c1db7362
+ | North-South resolution min:. 500.0
+ | North-South resolution max:. 500.0
+ | East-west resolution min:... 500.0
+ | East-west resolution max:... 500.0
+ | Minimum value min:.......... 0.0
+ | Minimum value max:.......... 95.58169
+ | Maximum value min:.......... 132.413284
+ | Maximum value max:.......... 356.502949
  | Aggregation type:........... None
- | Number of registered maps:.. 6
+ | Number of registered maps:.. 12
  |
  | Title:
- | Daily precipitation
+ | Monthly precipitation
  | Description:
- | Test dataset with daily precipitation
+ | Dataset with monthly precipitation
  | Command history:
- | # 2014-11-23 19:22:22 
+ | # 2014-11-28 15:52:30
  | t.create type="strds" temporaltype="absolute"
- |     output="precipitation_daily" title="Daily precipitation"
- |     description="Test dataset with daily precipitation"
- | # 2014-11-23 19:22:23 
- | t.register type="rast" input="precipitation_daily"
- |     maps="prec_1,prec_2,prec_3,prec_4,prec_5,prec_6" start="2012-01-01"
- |     increment="1 day"
- | # 2014-11-23 19:23:12 
- | t.snap type="strds" input="precipitation_daily"
- | 
+ |     output="precipitation_monthly" title="Monthly precipitation"
+ |     description="Dataset with monthly precipitation"
+ | # 2014-11-28 15:53:18
+ | t.register type="rast" input="precipitation_monthly"
+ |     maps="2012_01_precip,2012_02_precip, ... ,2012_11_precip,2012_12_precip"
+ |     start="2012-01-01" increment="1 months"
+ | # 2014-11-28 15:54:28
+ | t.snap type="strds" input="precipitation_monthly"
+ |
  +----------------------------------------------------------------------------+
 
+
+# now instead end time is set
+
 t.rast.list input=precipitation_daily
 
-name|mapset|start_time|end_time
-prec_1|PERMANENT|2012-01-01 00:00:00|2012-01-02 00:00:00
-prec_2|PERMANENT|2012-01-02 00:00:00|2012-01-03 00:00:00
-prec_3|PERMANENT|2012-01-03 00:00:00|2012-01-04 00:00:00
-prec_4|PERMANENT|2012-01-04 00:00:00|2012-01-05 00:00:00
-prec_5|PERMANENT|2012-01-05 00:00:00|2012-01-06 00:00:00
-prec_6|PERMANENT|2012-01-06 00:00:00|2012-01-07 00:00:00
+2012_01_precip|climate_2009_2012|2012-01-01 00:00:00|2012-02-01 00:00:00
+2012_02_precip|climate_2009_2012|2012-02-01 00:00:00|2012-03-01 00:00:00
+2012_03_precip|climate_2009_2012|2012-03-01 00:00:00|2012-04-01 00:00:00
+2012_04_precip|climate_2009_2012|2012-04-01 00:00:00|2012-05-01 00:00:00
+2012_05_precip|climate_2009_2012|2012-05-01 00:00:00|2012-06-01 00:00:00
+2012_06_precip|climate_2009_2012|2012-06-01 00:00:00|2012-07-01 00:00:00
+2012_07_precip|climate_2009_2012|2012-07-01 00:00:00|2012-08-01 00:00:00
+2012_08_precip|climate_2009_2012|2012-08-01 00:00:00|2012-09-01 00:00:00
+2012_09_precip|climate_2009_2012|2012-09-01 00:00:00|2012-10-01 00:00:00
+2012_10_precip|climate_2009_2012|2012-10-01 00:00:00|2012-11-01 00:00:00
+2012_11_precip|climate_2009_2012|2012-11-01 00:00:00|2012-12-01 00:00:00
+2012_12_precip|climate_2009_2012|2012-12-01 00:00:00|2013-01-01 00:00:00
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.support/t.support.html

@@ -2,15 +2,15 @@
 
 This module is dedicated to modify and update the metadata of a space time dataset.
 <p>
-The title, description and the semantic type can be modified. 
+The title, description and the semantic type can be modified.
 <p>
-The flag <em>-u</em> allows to update the STDS metadata from registered 
-map layers. This is useful in case the map layers have been modified 
-without using temporal commands. 
+The flag <em>-u</em> allows to update the STDS metadata from registered
+map layers. This is useful in case the map layers have been modified
+without using temporal commands.
 <p>
-The flag <em>-m</em> will update the metadata from registered maps, but 
-also checks if the registered map layers have been removed from the 
-spatial database. It deletes missing map layers from the space time 
+The flag <em>-m</em> will update the metadata from registered maps, but
+also checks if the registered map layers have been removed from the
+spatial database. It deletes missing map layers from the space time
 dataset register table and the temporal database.
 
 <h2>Examples</h2>
@@ -18,14 +18,15 @@ dataset register table and the temporal database.
 Modification of title and description of space time raster dataset <em>A</em>.
 <p>
 <div class="code"><pre>
-t.support type=strds input=A title="New title" description="New description"
+t.support type=strds input=tempmean_monthly title="Monthly temperature for North Carolina" \
+          description="Dataset with monthly temperature for North Carolina"
 </pre></div>
 <p>
-Update the metadata of space time raster dataset <em>A</em> and check 
+Update the metadata of space time raster dataset <em>A</em> and check
 for removed map layers.
 <p>
 <div class="code"><pre>
-t.support -m type=strds input=A
+t.support -m type=strds input=tempmean_monthly
 </pre></div>
 
 

temporal/t.topology/t.topology.html

@@ -5,10 +5,40 @@ a space time dataset.
 
 <h2>EXAMPLE</h2>
 
-The example is based on the XXX sample dataset:
+In order to obtain information about space time dataset topology, run:
 
 <div class="code"><pre>
-TBD
+t.topology tempmean_monthly@climate_2009_2012
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ tempmean_monthly@climate_2009_2012
+ | Name: ...................... tempmean_monthly
+ | Mapset: .................... climate_2009_2012
+ | Creator: ................... lucadelu
+ | Temporal type: ............. absolute
+ | Creation time: ............. 2014-11-28 10:40:55.060096
+ | Modification time:.......... 2014-11-28 16:08:42.166628
+ | Semantic type:.............. mean
+ +-------------------- Temporal topology -------------------------------------+
+ | Is subset of dataset: ...... False
+ | Temporal topology is: ...... valid
+ | Number of intervals: ....... 48
+ | Invalid time stamps: ....... 0
+ | Number of points: .......... 0
+ | Number of gaps: ............ 0
+ | Granularity: ............... 1 month
+ +-------------------- Topological relations ---------------------------------+
+ | Overlaps: .................. 0
+ | Overlapped: ................ 0
+ | Finishes: .................. 0
+ | Started: ................... 0
+ | Follows: ................... 47
+ | Contains: .................. 0
+ | Equal:...................... 0
+ | Finished: .................. 0
+ | Precedes: .................. 47
+ | Starts: .................... 0
+ | During: .................... 0
+ +----------------------------------------------------------------------------+
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.unregister/t.unregister.html

@@ -1,13 +1,13 @@
 <h2>DESCRIPTION</h2>
 
-This module is designed to unregister raster, 3D raster and vector map 
+This module is designed to unregister raster, 3D raster and vector map
 layers from space time datasets and the temporal database.
 
 <p>
-Map layer that should be unregistered from the temporal database can be 
-specified as a list of comma separated map names or using a text file, 
-that contains one map layer name per line. By default the map type that 
-should be unregistered is set to raster. The option<em>type</em> must 
+Map layer that should be unregistered from the temporal database can be
+specified as a list of comma separated map names or using a text file,
+that contains one map layer name per line. By default the map type that
+should be unregistered is set to raster. The option<em>type</em> must
 be used to specify 3D raster or vector map layer types.
 
 <h2>INPUT FILE FORMAT</h2>
@@ -25,36 +25,28 @@ a6
 <h3>NOTE</h3>
 In case the <em>input</em> option is used to specify a space time dataset
 the maps are only unregistered from the space time dataset, but not from the
-temporal database. The reason is that maps can be registered in 
-multiple space time datasets and there is a need to 
+temporal database. The reason is that maps can be registered in
+multiple space time datasets and there is a need to
 unregister them from a specific STDS without affecting other STDS.
 
 <h2>EXAMPLE</h2>
 
-In this example we create 2 raster map layers that will be registered 
-in a space time raster dataset named <em>A</em> using a 
-monthly temporal granularity. We use t.unregister to unregister a map 
-layer from the space time dataset and from the temporal database.
+In this example a precipitation map it is registered into temperature
+dataset, so the wrong map will be unregister.
 
 <div class="code"><pre>
-r.mapcalc expr="a1 = 100"
-r.mapcalc expr="a2 = 200"
 
-t.create type=strds temporaltype=absolute \
-    output=A title="Example" \
-    descr="Example"
+t.register -i type=rast input=tempmean_monthly@climate_2009_2012 \
+    maps=2012_01_precip \
+    start="2013-01-01" increment="1 month"
 
-t.register -i type=rast input=A \
-    maps=a1,a2 \
-    start="2001-01-01" increment="1 month"
-
-# We unregister raster maps a1 and a2 from a space time dataset,
+# We unregister raster map 2012_01_precip from a space time dataset,
 # the raster maps are still present in the temporal database
-t.unregister type=rast input=A maps=a1,a2
+t.unregister type=rast input=tempmean_monthly@climate_2009_2012 maps=2012_01_precip
 
-# We unregister raster map a1 and a2 from the temporal database, hence
+# We unregister raster map 2012_01_precip from the temporal database, hence
 # the time stamps are removed
-t.unregister type=rast maps=a1,a2
+t.unregister type=rast maps=2012_01_precip
 </pre></div>
 
 

temporal/t.vect.db.select/t.vect.db.select.html

@@ -6,10 +6,39 @@ registered in a space time vector dataset.
 
 <h2>EXAMPLE</h2>
 
-The example is based on the XXX sample dataset:
+The example is querying the <em>shoreline</em> space time dataset:
 
 <div class="code"><pre>
-TBD
+t.vect.db.select in=shoreline
+start_time|end_time|cat|DESCR|SOURCE|DATE
+1849|1873|1|T-736|NOAA/USGS|01/01/1858
+1849|1873|2|T-657|NOAA/USGS|01/01/1857
+1849|1873|3|T-381(2)|NOAA/USGS|01/01/1852
+1849|1873|4|T-381(1)|NOAA/USGS|01/01/1852
+1849|1873|5|T-381(1)|NOAA/USGS|01/01/1852
+...
+2009||44|2009 USDA NAIP|2009-07-11|VA, SAND, Wet / Dry
+2009||45|2009 USDA NAIP|2009-07-11|Carolina Beach, SAND, Wet / Dry
+2009||46|2009 USDA NAIP|2009-07-11|Carolina Beach, REVETMENT-ROCK, Hard Structure
+2009||47|2009 USDA NAIP|2009-07-11|Fort Fisher, REVETMENT-ROCK, Hard Structure
+</pre></div>
+
+In the following example it print only DATE and SOURCE columns for data
+before 1900-01-01.
+
+<div class="code"><pre>
+t.vect.db.select in=shoreline column=DATE,SOURCE t_where="start_time < 1900"
+start_time|end_time|DATE|SOURCE
+1849|1873|01/01/1858|NOAA/USGS
+1849|1873|01/01/1857|NOAA/USGS
+1849|1873|01/01/1852|NOAA/USGS
+1849|1873|01/01/1852|NOAA/USGS
+...
+1849|1873|01/01/1860|NOAA/USGS
+1849|1873|01/01/1860|NOAA/USGS
+1849|1873|01/01/1873|Coastal Carolina University
+1849|1873|01/01/1873|Coastal Carolina University
+1849|1873|01/01/1873|Coastal Carolina University
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.vect.export/t.vect.export.html

@@ -28,50 +28,44 @@ Each vector map represents random locations
 within the boundary of the state taken at 1 month intervals.
 
 <div class="code"><pre>
-db.connect -d
-
-for i in `seq 1 5` ; do
-    v.random output=map_$i n=500 input=boundary_state@PERMANENT
-    echo map_$i >> map_list.txt
-done
-
-t.create type=stvds temporaltype=absolute \
-         output=random_locations \
-         title="Random locations" \
-         description="Vector test dataset with random locations"
-
-t.register -i type=vect input=random_locations \
-           file=map_list.txt start="2012-01-01" increment="1 months"
-
-t.vect.export input=random_locations output=random_locations.tar
-
-tar xvf random_locations.tar
-map_1.xml
-map_1.xsd
-map_2.xml
-map_2.xsd
-map_3.xml
-map_3.xsd
-map_4.xml
-map_4.xsd
-map_5.xml
-map_5.xsd
+    
+t.vect.export in=shoreline out=shoreline_nc
+
+tar xvfj shoreline_nc
+shoreline_1849_1873.xml
+shoreline_1849_1873.xsd
+shoreline_1925_1946.xml
+shoreline_1925_1946.xsd
+shoreline_1970_1988.xml
+shoreline_1970_1988.xsd
+shoreline_1997.xml
+shoreline_1997.xsd
+shoreline_1998.xml
+shoreline_1998.xsd
+shoreline_2003.xml
+shoreline_2003.xsd
+shoreline_2004.xml
+shoreline_2004.xsd
+shoreline_2009.xml
+shoreline_2009.xsd
 list.txt
 proj.txt
 init.txt
 readme.txt
 metadata.txt
 
+
 cat init.txt
 stds_type=stvds
 format=GML
-temporal_type=absolute
+temporal_type=relative
 semantic_type=mean
-number_of_maps=5
-north=258414.015442
-south=185016.401592
-east=678328.848292
-west=596711.453211
+relative_time_unit=years
+number_of_maps=8
+north=1039175.31479
+south=9403.301982
+east=3052352.00337
+west=651481.84739
 
 cat proj.txt
 +proj=lcc
@@ -87,12 +81,17 @@ cat proj.txt
 +towgs84=0.000,0.000,0.000
 +to_meter=1
 
+
 cat list.txt
-map_1|2012-01-01 00:00:00|2012-02-01 00:00:00
-map_2|2012-02-01 00:00:00|2012-03-01 00:00:00
-map_3|2012-03-01 00:00:00|2012-04-01 00:00:00
-map_4|2012-04-01 00:00:00|2012-05-01 00:00:00
-map_5|2012-05-01 00:00:00|2012-06-01 00:00:00
+shoreline_1849_1873|1849|1873
+shoreline_1925_1946|1925|1946
+shoreline_1970_1988|1970|1988
+shoreline_1997|1997|1997
+shoreline_1998|1998|1998
+shoreline_2003|2003|2003
+shoreline_2004|2004|2004
+shoreline_2009|2009|2009
+
 
 cat readme.txt
 This space time vector dataset was exported with t.vect.export of GRASS GIS 7
@@ -105,6 +104,7 @@ Files:
                  time stamps in ISO-Format. Field separator is |
  metadata.txt -- The output of t.info
    readme.txt -- This file
+
 </pre></div>
 
 

temporal/t.vect.extract/t.vect.extract.html

@@ -6,10 +6,74 @@ vector dataset.
 
 <h2>EXAMPLE</h2>
 
-The example is based on the XXX sample dataset:
+In the following example a new space time vector dataset will be create
+with all the data later than 2000:
 
 <div class="code"><pre>
-TBD
+t.vect.extract inp=shoreline where="start_time > 2000" \
+               out=shoreline_later_2000 basename=new_shoreline
+
+t.info shoreline_later_2000@shoreline type=stvds
+ +-------------------- Space Time Vector Dataset -----------------------------+
+ |                                                                            |
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ shoreline_later_2000@shoreline
+ | Name: ...................... shoreline_later_2000
+ | Mapset: .................... shoreline
+ | Creator: ................... lucadelu
+ | Temporal type: ............. relative
+ | Creation time: ............. 2014-11-29 08:43:50.043219
+ | Modification time:.......... 2014-11-29 08:43:50.085407
+ | Semantic type:.............. mean
+ +-------------------- Relative time -----------------------------------------+
+ | Start time:................. 2003
+ | End time:................... 2009
+ | Relative time unit:......... years
+ | Granularity:................ 1
+ | Temporal type of maps:...... point
+ +-------------------- Spatial extent ----------------------------------------+
+ | North:...................... 1039175.31479
+ | South:...................... 34705.216018
+ | East:.. .................... 3052322.44671
+ | West:....................... 2130004.16779
+ | Top:........................ 0.0
+ | Bottom:..................... 0.0
+ +-------------------- Metadata information ----------------------------------+
+ | Vector register table:...... vector_map_register_8395740fc8de42149fef74a3d25bbb05
+ | Number of points ........... 0
+ | Number of lines ............ 407
+ | Number of boundaries ....... 0
+ | Number of centroids ........ 0
+ | Number of faces ............ 0
+ | Number of kernels .......... 0
+ | Number of primitives ....... 407
+ | Number of nodes ............ 767
+ | Number of areas ............ 0
+ | Number of islands .......... 0
+ | Number of holes ............ 0
+ | Number of volumes .......... 0
+ | Number of registered maps:.. 3
+ |
+ | Title:
+ | North Carolina shoreline
+ | Description:
+ | North Caroline shoreline from 2000 to 2009
+ | Command history:
+ | # 2014-11-29 08:43:50 
+ | t.vect.extract inp="shoreline"
+ |     where="start_time > 2000" out="shoreline_later_2000"
+ |     basename="new_shoreline"
+ | # 2014-11-29 08:44:14 
+ | t.support type="stvds"
+ |     in="shoreline_later_2000@shoreline"
+ |     descr="North Caroline shoreline from 2000 to 2009"
+ +----------------------------------------------------------------------------+
+
+t.vect.list shoreline_later_2000
+name|layer|mapset|start_time|end_time
+shoreline_2003|None|shoreline|2003|None
+shoreline_2004|None|shoreline|2004|None
+shoreline_2009|None|shoreline|2009|None
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.vect.list/t.vect.list.html

@@ -3,16 +3,54 @@
 <!-- this needs to be expanded -->
 
 This module provides the same functionality as
-<a href="t.rast.list.html">t.rast.list</a>, the only difference is the 
-vector map layer metadata. Please refer to the manual page of
-<a href="t.rast.list.html">t.rast.list</a>.
+<a href="t.rast.list.html">t.rast.list</a>, the only difference is the
+vector map layer metadata.
 
 <h2>EXAMPLE</h2>
 
-The example is based on the XXX sample dataset:
+<h3>Default query</h3>
+
+This example show a relative space time vector dataset with the first
+three maps with a range of years, instead the last five are valid only
+for one year:
+
+<div class="code"><pre>
+t.vect.list shoreline@shoreline
+name|layer|mapset|start_time|end_time
+shoreline_1849_1873|None|shoreline|1849|1873
+shoreline_1925_1946|None|shoreline|1925|1946
+shoreline_1970_1988|None|shoreline|1970|1988
+shoreline_1997|None|shoreline|1997|None
+shoreline_1998|None|shoreline|1998|None
+shoreline_2003|None|shoreline|2003|None
+shoreline_2004|None|shoreline|2004|None
+shoreline_2009|None|shoreline|2009|None
+</pre></div>
+
+<h3>Using method option</h3>
+
+Method option is able to show vector in different way. By default <em>cols</em>
+value is used, the value <em>deltagaps</em> will print the delta between
+maps and also the gaps if they exist (like in this example).
 
 <div class="code"><pre>
-TBD
+t.vect.list method=deltagaps in=shoreline
+id|name|layer|mapset|start_time|end_time|interval_length|distance_from_begin
+shoreline_1849_1873@shoreline|shoreline_1849_1873|None|shoreline|1849|1873|24|0
+None|None|None|None|1873|1925|52|24
+shoreline_1925_1946@shoreline|shoreline_1925_1946|None|shoreline|1925|1946|21|76
+None|None|None|None|1946|1970|24|97
+shoreline_1970_1988@shoreline|shoreline_1970_1988|None|shoreline|1970|1988|18|121
+None|None|None|None|1988|1997|9|139
+shoreline_1997@shoreline|shoreline_1997|None|shoreline|1997|None|None|148
+None|None|None|None|1997|1998|1|148
+shoreline_1998@shoreline|shoreline_1998|None|shoreline|1998|None|None|149
+None|None|None|None|1998|2003|5|149
+shoreline_2003@shoreline|shoreline_2003|None|shoreline|2003|None|None|154
+None|None|None|None|2003|2004|1|154
+shoreline_2004@shoreline|shoreline_2004|None|shoreline|2004|None|None|155
+None|None|None|None|2004|2009|5|155
+shoreline_2009@shoreline|shoreline_2009|None|shoreline|2009|None|None|160
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.vect.observe.strds/t.vect.observe.strds.html

@@ -6,10 +6,104 @@ vector points.
 
 <h2>EXAMPLE</h2>
 
-The example is based on the XXX sample dataset:
+The example how to create a space time vector dataset and a vector layer
+starting from a point vector and a space time raster dataset:
 
 <div class="code"><pre>
-TBD
+t.vect.observe.strds in=precip_30ynormals_3d strds=tempmean_monthly \
+                     out=precip_stations vect=precip_stations_monthly \
+                     columns=month
+
+t.info precip_stations type=stvds
+ +-------------------- Space Time Vector Dataset -----------------------------+
+ |                                                                            |
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ precip_stations@climate_2009_2012
+ | Name: ...................... precip_stations
+ | Mapset: .................... climate_2009_2012
+ | Creator: ................... lucadelu
+ | Temporal type: ............. absolute
+ | Creation time: ............. 2014-12-02 00:42:39.187615
+ | Modification time:.......... 2014-12-02 00:42:55.215169
+ | Semantic type:.............. mean
+ +-------------------- Absolute time -----------------------------------------+
+ | Start time:................. 2009-01-01 00:00:00
+ | End time:................... 2013-01-01 00:00:00
+ | Granularity:................ 1 month
+ | Temporal type of maps:...... interval
+ +-------------------- Spatial extent ----------------------------------------+
+ | North:...................... 306221.830194
+ | South:...................... 27606.895351
+ | East:.. .................... 917004.829165
+ | West:....................... 151768.568246
+ | Top:........................ 1615.44
+ | Bottom:..................... 2.4384
+ +-------------------- Metadata information ----------------------------------+
+ | Vector register table:...... vector_map_register_be074525097c4088997c9a1979f17065
+ | Number of points ........... 6664
+ | Number of lines ............ 0
+ | Number of boundaries ....... 0
+ | Number of centroids ........ 0
+ | Number of faces ............ 0
+ | Number of kernels .......... 0
+ | Number of primitives ....... 6664
+ | Number of nodes ............ 0
+ | Number of areas ............ 0
+ | Number of islands .......... 0
+ | Number of holes ............ 0
+ | Number of volumes .......... 0
+ | Number of registered maps:.. 49
+ |
+ | Title:
+ | Observaion of space time raster dataset(s) tempmean_monthly
+ | Description:
+ | Observation of space time raster dataset(s) tempmean_monthly with vector map precip_30ynormals_3d
+ | Command history:
+ | # 2014-12-02 00:42:39
+ | t.vect.observe.strds in="precip_30ynormals_3d"
+ |     strds="tempmean_monthly" out="precip_stations"
+ |     vect="precip_stations_monthly" columns="month"
+ |
+ +----------------------------------------------------------------------------+
+
+
+v.info precip_stations_monthly
+ +----------------------------------------------------------------------------+
+ | Name:            precip_stations_monthly                                   |
+ | Mapset:          climate_2009_2012                                         |
+ | Location:        nc_spm_temporal_workshop                                  |
+ | Database:        /grassdata                                                |
+ | Title:           North Carolina 30 year precipitation normals (3D)         |
+ | Map scale:       1:1                                                       |
+ | Name of creator: neteler                                                   |
+ | Organization:                                                              |
+ | Source date:     Wed May  9 14:32:39 2007                                  |
+ | Timestamp (first layer): none                                              |
+ |----------------------------------------------------------------------------|
+ | Map format:      native                                                    |
+ |----------------------------------------------------------------------------|
+ |   Type of map: vector (level: 2)                                           |
+ |                                                                            |
+ |   Number of points:       136             Number of centroids:  0          |
+ |   Number of lines:        0               Number of boundaries: 0          |
+ |   Number of areas:        0               Number of islands:    0          |
+ |   Number of faces:        0               Number of kernels:    0          |
+ |   Number of volumes:      0               Number of holes:      0          |
+ |                                                                            |
+ |   Map is 3D:              Yes                                              |
+ |   Number of dblinks:      49                                               |
+ |                                                                            |
+ |   Projection: Lambert Conformal Conic                                      |
+ |                                                                            |
+ |               N:     306221.830194    S:      27606.895351                 |
+ |               E:     917004.829165    W:     151768.568246                 |
+ |               B:            2.4384    T:           1615.44                 |
+ |                                                                            |
+ |   Digitization threshold: 0                                                |
+ |   Comment:                                                                 |
+ |                                                                            |
+ +----------------------------------------------------------------------------+
+
 </pre></div>
 
 <h2>SEE ALSO</h2>

temporal/t.vect.univar/t.vect.univar.html

@@ -6,10 +6,19 @@ space time vector dataset based on a single attribute row.
 
 <h2>EXAMPLE</h2>
 
-The example is based on the XXX sample dataset:
+The example is based on the <a herf="t.vect.observe.strds.html">t.vect.observe.strds</a>
+example; so create the <b>precip_stations</b> space time vector dataset
+and after run the following command:
 
 <div class="code"><pre>
-TBD
+ t.vect.univar in=precip_stations col=month
+id|start|end|n|nmissing|nnull|min|max|range|mean|mean_abs|population_stddev|population_variance|population_coeff_variation|sample_stddev|sample_variance|kurtosis|skewness
+precip_stations_monthly@climate_2009_2012|2009-01-01 00:00:00|2009-02-01 00:00:00|132|0|4|-2.31832|7.27494|9.59326|3.44624|3.5316|1.79322|3.21564|0.520341|1.80005|3.24019|0.484515|-0.338519
+precip_stations_monthly@climate_2009_2012|2009-02-01 00:00:00|2009-03-01 00:00:00|132|0|4|-0.654152|7.90613|8.56028|5.47853|5.48844|1.73697|3.01708|0.317051|1.74359|3.04011|0.875252|-1.0632
+....
+precip_stations_monthly@climate_2009_2012|2012-10-01 00:00:00|2012-11-01 00:00:00|132|0|4|9.67596|18.4654|8.78945|14.945|14.945|1.90659|3.6351|0.127574|1.91386|3.66285|-0.0848967|-0.700833
+precip_stations_monthly@climate_2009_2012|2012-11-01 00:00:00|2012-12-01 00:00:00|132|0|4|3.56755|10.6211|7.05357|7.72153|7.72153|1.33684|1.78715|0.173132|1.34194|1.8008|0.90434|-0.863935
+precip_stations_monthly@climate_2009_2012|2012-12-01 00:00:00|2013-01-01 00:00:00|132|0|4|3.04325|11.6368|8.5935|8.20147|8.20147|1.78122|3.17275|0.217183|1.78801|3.19697|-0.177991|-0.501295
 </pre></div>
 
 <h2>SEE ALSO</h2>