~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>t.rast.to.rast3</em> is designed to convert a space time raster
 
4
dataset (STRDS) into a space time voxel cube. A space time voxel cube
 
5
is a 3 dimensional raster map layer (3D raster map or voxel map layer)
 
6
that as time as unit for the z-dimension.
 
7
<p>
 
8
A space time raster dataset that should be converted into a space time
 
9
voxel cube must have a valid temporal topology. Hence, overlapping or
 
10
inclusion of time stamps is not allowed. The granularity of the STRDS
 
11
is used to set the resolution of the 3D raster map layer and to sample
 
12
the registered time stamped raster map layers.
 
13
<p>
 
14
Gaps between raster map layer in the STRDS will
 
15
be represented by NULL values in the voxel map layer.
 
16
 
 
17
 
 
18
<h2>NOTE</h2>
 
19
 
 
20
The reference time for all space time voxel cubes is
 
21
1900-01-0100:00:00. This allows the alignment space time voxel cubes
 
22
with different granularities.
 
23
<p>
 
24
Be aware that the granularity of a STRDS is used to sample time stamped
 
25
map layers! If you have gaps between monthly intervals that have the
 
26
size of a second, the monthly intervals will be sampled by a second
 
27
based granularity as well. This may result in millions of space time
 
28
voxel cube layers!
 
29
 
 
30
<h2>EXAMPLE</h2>
 
31
To create a voxel map layer from a subset of the <em>tempmean_monthly</em>
 
32
space time dataset, run:
 
33
 
 
34
<div class="code"><pre>
 
35
# create the subset for 2012 data
 
36
t.rast.extract input=tempmean_monthly output=tempmean_monthly_later_2012 \
 
37
               where="start_time >= '2012-01-01'"
 
38
 
 
39
# set the right 3D region
 
40
g.region -p3 res3=500
 
41
 
 
42
# convert to 3D raster map
 
43
t.rast.to.rast3 in=tempmean_monthly_later_2012@climate_2009_2012 out=tempmean_monthly_2012
 
44
 
 
45
t.info type=raster_3d input=tempmean_monthly_2012
 
46
 +-------------------- 3D Raster Dataset -------------------------------------+
 
47
 |                                                                            |
 
48
 +-------------------- Basic information -------------------------------------+
 
49
 | Id: ........................ tempmean_monthly_2012@climate_2009_2012
 
50
 | Name: ...................... tempmean_monthly_2012
 
51
 | Mapset: .................... climate_2009_2012
 
52
 | Creator: ................... lucadelu
 
53
 | Temporal type: ............. absolute
 
54
 | Creation time: ............. 2014-11-28 11:10:51.679294
 
55
 +-------------------- Absolute time -----------------------------------------+
 
56
 | Start time:................. 2012-01-01 00:00:00
 
57
 | End time:................... 2013-01-01 00:00:00
 
58
 +-------------------- Spatial extent ----------------------------------------+
 
59
 | North:...................... 320000.0
 
60
 | South:...................... 10000.0
 
61
 | East:.. .................... 935000.0
 
62
 | West:....................... 120000.0
 
63
 | Top:........................ 1357.0
 
64
 | Bottom:..................... 1345.0
 
65
 +-------------------- Metadata information ----------------------------------+
 
66
 | Datatype:................... DCELL
 
67
 | Number of columns:.......... 620
 
68
 | Number of rows:............. 1630
 
69
 | Number of cells:............ 12127200
 
70
 | North-South resolution:..... 500.0
 
71
 | East-west resolution:....... 500.0
 
72
 | Minimum value:.............. -0.534994
 
73
 | Maximum value:.............. 28.794653
 
74
 | Number of depths:........... 12
 
75
 | Top-Bottom resolution:...... 1.0
 
76
 | Registered datasets ........
 
77
 +----------------------------------------------------------------------------+
 
78
 
 
79
 
 
80
r3.info tempmean_monthly_2012
 
81
 +----------------------------------------------------------------------------+
 
82
 | Layer:    tempmean_monthly_2012          Date: Fri Nov 28 11:10:50 2014    |
 
83
 | Mapset:   climate_2009_2012              Login of Creator: lucadelu        |
 
84
 | Location: nc_spm_temporal_workshop                                         |
 
85
 | DataBase: /grassdata                                                       |
 
86
 | Title:    Space time voxel cube                                            |
 
87
 | Units:    none                                                             |
 
88
 | Vertical unit: months                                                      |
 
89
 | Timestamp: none                                                            |
 
90
 |----------------------------------------------------------------------------|
 
91
 |                                                                            |
 
92
 |   Type of Map:  3d cell              Number of Categories: 0               |
 
93
 |   Data Type:    DCELL                                                      |
 
94
 |   Rows:         620                                                        |
 
95
 |   Columns:      1630                                                       |
 
96
 |   Depths:       12                                                         |
 
97
 |   Total Cells:  12127200                                                   |
 
98
 |   Total size:           28414287 Bytes                                     |
 
99
 |   Number of tiles:      4230                                               |
 
100
 |   Mean tile size:       6717 Bytes                                         |
 
101
 |   Tile size in memory:  23520 Bytes                                        |
 
102
 |   Number of tiles in x, y and  z:   47, 45, 2                              |
 
103
 |   Dimension of a tile in x, y, z:   35, 14, 6                              |
 
104
 |                                                                            |
 
105
 |        Projection: Lambert Conformal Conic (zone 0)                        |
 
106
 |            N:     320000    S:      10000   Res:   500                     |
 
107
 |            E:     935000    W:     120000   Res:   500                     |
 
108
 |            T:       1357    B:       1345   Res:     1                     |
 
109
 |   Range of data:   min = -0.53499434 max = 28.79465315                     |
 
110
 |                                                                            |
 
111
 |   Data Source:                                                             |
 
112
 |                                                                            |
 
113
 |                                                                            |
 
114
 |                                                                            |
 
115
 |   Data Description:                                                        |
 
116
 |    This space time voxel cube was created with t.rast.to.rast3             |
 
117
 |                                                                            |
 
118
 |   Comments:                                                                |
 
119
 |    r.to.rast3 input="2012_01_tempmean@climate_2009_2012,2012_02_tempmea\   |
 
120
 |    n@climate_2009_2012,2012_03_tempmean@climate_2009_2012,2012_04_tempm\   |
 
121
 |    ean@climate_2009_2012,2012_05_tempmean@climate_2009_2012,2012_06_tem\   |
 
122
 |    pmean@climate_2009_2012,2012_07_tempmean@climate_2009_2012,2012_08_t\   |
 
123
 |    empmean@climate_2009_2012,2012_09_tempmean@climate_2009_2012,2012_10\   |
 
124
 |    _tempmean@climate_2009_2012,2012_11_tempmean@climate_2009_2012,2012_\   |
 
125
 |    12_tempmean@climate_2009_2012" output="tempmean_monthly_2012" tilesi\   |
 
126
 |    ze=32                                                                   |
 
127
 |                                                                            |
 
128
 +----------------------------------------------------------------------------+
 
129
</pre></div>
 
130
 
 
131
<h2>SEE ALSO</h2>
 
132
 
 
133
<em>
 
134
<a href="r3.mapcalc.html">r3.mapcalc</a>,
 
135
<a href="r3.info.html">r3.info</a>
 
136
</em>
 
137
 
 
138
<h2>AUTHOR</h2>
 
139
 
 
140
S&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture
 
141
 
 
142
<p><i>Last changed: $Date: 2014-12-27 00:50:11 +0100 (Sat, 27 Dec 2014) $</i>
 
143