← Back to branch summary

~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

Viewing changes to temporal/t.snap/t.snap.html

Tags: 7.0.0~rc1+ds1-1~exp1
http://bugs.debian.org/776349
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

Show diffs side-by-side

added added

removed removed

Lines of Context:
temporal/t.snap/t.snap.html
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>t.snap</em> is designed to convert time instances of maps into time
 
4
intervals or to create valid temporal topologies for space time
 
5
datasets. Raster, 3D raster and vector space time datasets are
 
6
supported with absolute and relative time.
 
7
<p>
 
8
This module "snaps" the end time of each registered map of a space time
 
9
dataset to the start time of the map that is the temporal nearest
 
10
neighbour in the future. Maps with equal time stamps are not modified
 
11
and must be removed or modified to create a valid temporal topology. In
 
12
case the last map in the space time dataset is a time instance, the
 
13
granularity of the space time dataset will be used to create the time
 
14
interval.
 
15
 
 
16
<h2>EXAMPLE</h2>
 
17
 
 
18
A raster space time dataset will be create using precipitation maps for 2012
 
19
then using absolute time in a space time raster dataset using an increment
 
20
of one month.
 
21
At the end we snap the created time instances resulting in time intervals.
 
22
 
 
23
<div class="code"><pre>
 
24
# Generate data
 
25
 
 
26
t.create type=strds temporaltype=absolute \
 
27
         output=precipitation_monthly \
 
28
         title="Monthly precipitation" \
 
29
         description="Dataset with monthly precipitation"
 
30
 
 
31
t.register type=raster input=precipitation_monthly \
 
32
           maps=`g.list type=raster patt=2012*precip sep=,` \
 
33
           start=2012-01-01 increment="1 months"
 
34
 
 
35
# please take attention to "Temporal type of maps" value
 
36
t.info type=strds input=precipitation_monthly
 
37
 
 
38
 +-------------------- Space Time Raster Dataset -----------------------------+
 
39
 |                                                                            |
 
40
 +-------------------- Basic information -------------------------------------+
 
41
 | Id: ........................ precipitation_monthly@climate_2009_2012
 
42
 | Name: ...................... precipitation_monthly
 
43
 | Mapset: .................... climate_2009_2012
 
44
 | Creator: ................... lucadelu
 
45
 | Temporal type: ............. absolute
 
46
 | Creation time: ............. 2014-11-28 15:52:30.801148
 
47
 | Modification time:.......... 2014-11-28 15:53:18.430773
 
48
 | Semantic type:.............. mean
 
49
 +-------------------- Absolute time -----------------------------------------+
 
50
 | Start time:................. 2012-01-01 00:00:00
 
51
 | End time:................... 2012-12-01 00:00:00
 
52
 | Granularity:................ 1 month
 
53
 | Temporal type of maps:...... point
 
54
 +-------------------- Spatial extent ----------------------------------------+
 
55
 | North:...................... 320000.0
 
56
 | South:...................... 10000.0
 
57
 | East:.. .................... 935000.0
 
58
 | West:....................... 120000.0
 
59
 | Top:........................ 0.0
 
60
 | Bottom:..................... 0.0
 
61
 +-------------------- Metadata information ----------------------------------+
 
62
 | Raster register table:...... raster_map_register_282454f66ff5455299526ec3c1db7362
 
63
 | North-South resolution min:. 500.0
 
64
 | North-South resolution max:. 500.0
 
65
 | East-west resolution min:... 500.0
 
66
 | East-west resolution max:... 500.0
 
67
 | Minimum value min:.......... 0.0
 
68
 | Minimum value max:.......... 95.58169
 
69
 | Maximum value min:.......... 132.413284
 
70
 | Maximum value max:.......... 356.502949
 
71
 | Aggregation type:........... None
 
72
 | Number of registered maps:.. 12
 
73
 |
 
74
 | Title:
 
75
 | Monthly precipitation
 
76
 | Description:
 
77
 | Dataset with monthly precipitation
 
78
 | Command history:
 
79
 | # 2014-11-28 15:52:30
 
80
 | t.create type="strds" temporaltype="absolute"
 
81
 |     output="precipitation_monthly" title="Monthly precipitation"
 
82
 |     description="Dataset with monthly precipitation"
 
83
 | # 2014-11-28 15:53:18
 
84
 | t.register type="rast" input="precipitation_monthly"
 
85
 |     maps="2012_01_precip,2012_02_precip, ... ,2012_11_precip,2012_12_precip"
 
86
 |     start="2012-01-01" increment="1 months"
 
87
 |
 
88
 +----------------------------------------------------------------------------+
 
89
 
 
90
 
 
91
# you can see that end time is not set
 
92
t.rast.list input=precipitation_monthly
 
93
 
 
94
name|mapset|start_time|end_time
 
95
2012_01_precip|climate_2009_2012|2012-01-01 00:00:00|None
 
96
2012_02_precip|climate_2009_2012|2012-02-01 00:00:00|None
 
97
2012_03_precip|climate_2009_2012|2012-03-01 00:00:00|None
 
98
2012_04_precip|climate_2009_2012|2012-04-01 00:00:00|None
 
99
2012_05_precip|climate_2009_2012|2012-05-01 00:00:00|None
 
100
2012_06_precip|climate_2009_2012|2012-06-01 00:00:00|None
 
101
2012_07_precip|climate_2009_2012|2012-07-01 00:00:00|None
 
102
2012_08_precip|climate_2009_2012|2012-08-01 00:00:00|None
 
103
2012_09_precip|climate_2009_2012|2012-09-01 00:00:00|None
 
104
2012_10_precip|climate_2009_2012|2012-10-01 00:00:00|None
 
105
2012_11_precip|climate_2009_2012|2012-11-01 00:00:00|None
 
106
2012_12_precip|climate_2009_2012|2012-12-01 00:00:00|None
 
107
 
 
108
 
 
109
 
 
110
t.snap type=strds input=precipitation_monthly
 
111
 
 
112
# please take attention to "Temporal type of maps" value again
 
113
t.info type=strds input=precipitation_monthly
 
114
 
 
115
 +-------------------- Space Time Raster Dataset -----------------------------+
 
116
 |                                                                            |
 
117
 +-------------------- Basic information -------------------------------------+
 
118
 | Id: ........................ precipitation_monthly@climate_2009_2012
 
119
 | Name: ...................... precipitation_monthly
 
120
 | Mapset: .................... climate_2009_2012
 
121
 | Creator: ................... lucadelu
 
122
 | Temporal type: ............. absolute
 
123
 | Creation time: ............. 2014-11-28 15:52:30.801148
 
124
 | Modification time:.......... 2014-11-28 15:54:28.739905
 
125
 | Semantic type:.............. mean
 
126
 +-------------------- Absolute time -----------------------------------------+
 
127
 | Start time:................. 2012-01-01 00:00:00
 
128
 | End time:................... 2013-01-01 00:00:00
 
129
 | Granularity:................ 1 month
 
130
 | Temporal type of maps:...... interval
 
131
 +-------------------- Spatial extent ----------------------------------------+
 
132
 | North:...................... 320000.0
 
133
 | South:...................... 10000.0
 
134
 | East:.. .................... 935000.0
 
135
 | West:....................... 120000.0
 
136
 | Top:........................ 0.0
 
137
 | Bottom:..................... 0.0
 
138
 +-------------------- Metadata information ----------------------------------+
 
139
 | Raster register table:...... raster_map_register_282454f66ff5455299526ec3c1db7362
 
140
 | North-South resolution min:. 500.0
 
141
 | North-South resolution max:. 500.0
 
142
 | East-west resolution min:... 500.0
 
143
 | East-west resolution max:... 500.0
 
144
 | Minimum value min:.......... 0.0
 
145
 | Minimum value max:.......... 95.58169
 
146
 | Maximum value min:.......... 132.413284
 
147
 | Maximum value max:.......... 356.502949
 
148
 | Aggregation type:........... None
 
149
 | Number of registered maps:.. 12
 
150
 |
 
151
 | Title:
 
152
 | Monthly precipitation
 
153
 | Description:
 
154
 | Dataset with monthly precipitation
 
155
 | Command history:
 
156
 | # 2014-11-28 15:52:30
 
157
 | t.create type="strds" temporaltype="absolute"
 
158
 |     output="precipitation_monthly" title="Monthly precipitation"
 
159
 |     description="Dataset with monthly precipitation"
 
160
 | # 2014-11-28 15:53:18
 
161
 | t.register type="rast" input="precipitation_monthly"
 
162
 |     maps="2012_01_precip,2012_02_precip, ... ,2012_11_precip,2012_12_precip"
 
163
 |     start="2012-01-01" increment="1 months"
 
164
 | # 2014-11-28 15:54:28
 
165
 | t.snap type="strds" input="precipitation_monthly"
 
166
 |
 
167
 +----------------------------------------------------------------------------+
 
168
 
 
169
 
 
170
# now instead end time is set
 
171
 
 
172
t.rast.list input=precipitation_daily
 
173
 
 
174
2012_01_precip|climate_2009_2012|2012-01-01 00:00:00|2012-02-01 00:00:00
 
175
2012_02_precip|climate_2009_2012|2012-02-01 00:00:00|2012-03-01 00:00:00
 
176
2012_03_precip|climate_2009_2012|2012-03-01 00:00:00|2012-04-01 00:00:00
 
177
2012_04_precip|climate_2009_2012|2012-04-01 00:00:00|2012-05-01 00:00:00
 
178
2012_05_precip|climate_2009_2012|2012-05-01 00:00:00|2012-06-01 00:00:00
 
179
2012_06_precip|climate_2009_2012|2012-06-01 00:00:00|2012-07-01 00:00:00
 
180
2012_07_precip|climate_2009_2012|2012-07-01 00:00:00|2012-08-01 00:00:00
 
181
2012_08_precip|climate_2009_2012|2012-08-01 00:00:00|2012-09-01 00:00:00
 
182
2012_09_precip|climate_2009_2012|2012-09-01 00:00:00|2012-10-01 00:00:00
 
183
2012_10_precip|climate_2009_2012|2012-10-01 00:00:00|2012-11-01 00:00:00
 
184
2012_11_precip|climate_2009_2012|2012-11-01 00:00:00|2012-12-01 00:00:00
 
185
2012_12_precip|climate_2009_2012|2012-12-01 00:00:00|2013-01-01 00:00:00
 
186
</pre></div>
 
187
 
 
188
<h2>SEE ALSO</h2>
 
189
 
 
190
<em>
 
191
<a href="t.shift.html">t.shift</a>,
 
192
<a href="t.create.html">t.create</a>,
 
193
<a href="t.register.html">t.register</a>
 
194
</em>
 
195
 
 
196
<h2>AUTHOR</h2>
 
197
 
 
198
S&ouml;ren Gebbert, Th&uuml;nen Institute of Climate-Smart Agriculture
 
199
 
 
200
<p><i>Last changed: $Date: 2014-12-27 00:50:11 +0100 (Sat, 27 Dec 2014) $</i>
 
201