[GRASS-SVN] r61732 - grass/trunk/temporal/t.rast.aggregate
svn_grass at osgeo.org
svn_grass at osgeo.org
Mon Aug 25 02:53:40 PDT 2014
Author: huhabla
Date: 2014-08-25 02:53:40 -0700 (Mon, 25 Aug 2014)
New Revision: 61732
Modified:
grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html
Log:
Manual page update to describe the new nprocs option and the new temporal relation scheme
Modified: grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html
===================================================================
--- grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html 2014-08-24 22:13:58 UTC (rev 61731)
+++ grass/trunk/temporal/t.rast.aggregate/t.rast.aggregate.html 2014-08-25 09:53:40 UTC (rev 61732)
@@ -33,6 +33,15 @@
<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 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
@@ -43,7 +52,8 @@
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 in a week. The sampling option assures that only raster maps that are
+of all raster maps that are tempoorally <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>
@@ -64,28 +74,40 @@
t.info type=strds input=precipitation_daily
+ +-------------------- Space Time Raster Dataset -----------------------------+
+ | |
+ +-------------------- Basic information -------------------------------------+
+ | Id: ........................ precipitation_daily at PERMANENT
+ | Name: ...................... precipitation_daily
+ | Mapset: .................... PERMANENT
+ | Creator: ................... soeren
+ | Temporal type: ............. absolute
+ | Creation time: ............. 2014-08-25 11:26:43.088786
+ | Modification time:.......... 2014-08-25 11:26:43.533237
+ | Semantic type:.............. mean
+-------------------- Absolute time -----------------------------------------+
- | Start time:................. 2012-09-03 00:00:00
- | End time:................... 2012-09-10 00:00:00
+ | Start time:................. 2012-08-20 00:00:00
+ | End time:................... 2012-08-27 00:00:00
| Granularity:................ 1 day
| Temporal type of maps:...... interval
+-------------------- Spatial extent ----------------------------------------+
| North:...................... 80.0
- | South:...................... -1.0
- | East:.. .................... 120.5
- | West:....................... -40.5
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_daily_test_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_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
|
| Title:
@@ -93,11 +115,11 @@
| Description:
| Test dataset with daily precipitation
| Command history:
- | # 2013-07-13 13:10:46
+ | # 2014-08-25 11:26:43
| t.create type="strds" temporaltype="absolute"
| output="precipitation_daily" title="Daily precipitation"
| description="Test dataset with daily precipitation"
- | # 2013-07-13 13:10:47
+ | # 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"
|
@@ -106,7 +128,7 @@
t.rast.aggregate input=precipitation_daily \
output=precipitation_weekly \
base=prec_weekly granularity="1 weeks" \
- method=sum sampling=during
+ method=sum sampling=contains
t.support input=precipitation_weekly \
title="Weekly precipitation" \
@@ -117,35 +139,37 @@
+-------------------- Space Time Raster Dataset -----------------------------+
| |
+-------------------- Basic information -------------------------------------+
- | Id: ........................ precipitation_weekly at test
+ | Id: ........................ precipitation_weekly at PERMANENT
| Name: ...................... precipitation_weekly
- | Mapset: .................... test
+ | Mapset: .................... PERMANENT
| Creator: ................... soeren
- | Creation time: ............. 2013-07-13 13:11:23.286982
| 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-09-03 00:00:00
- | End time:................... 2012-09-10 00:00:00
+ | 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:...................... -1.0
- | East:.. .................... 120.5
- | West:....................... -40.5
+ | South:...................... 0.0
+ | East:.. .................... 120.0
+ | West:....................... 0.0
| Top:........................ 0.0
| Bottom:..................... 0.0
+-------------------- Metadata information ----------------------------------+
- | Raster register table:...... precipitation_weekly_test_raster_register
- | North-South resolution min:. 1.0
- | North-South resolution max:. 1.0
- | East-west resolution min:... 1.0
- | East-west resolution max:... 1.0
+ | Raster register table:...... raster_map_register_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
|
| Title:
@@ -153,11 +177,11 @@
| Description:
| Aggregated precipitation dataset with weekly resolution
| Command history:
- | # 2013-07-13 13:11:23
+ | # 2014-08-25 11:33:25
| t.rast.aggregate input="precipitation_daily"
| output="precipitation_weekly" base="prec_weekly" granularity="1 weeks"
- | method="sum" sampling="during"
- | # 2013-07-13 13:11:29
+ | 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"
More information about the grass-commit
mailing list