1t.rast.export(1) GRASS GIS User's Manual t.rast.export(1)
2
3
4
6 t.rast.export - Exports space time raster dataset.
7
9 temporal, export, raster, time
10
12 t.rast.export
13 t.rast.export --help
14 t.rast.export input=name output=name [directory=name] [compres‐
15 sion=string] [format=string] [type=string] [cre‐
16 ateopt=string[,string,...]] [metaopt=string[,string,...]]
17 [nodata=float] [where=sql_query] [--overwrite] [--help] [--ver‐
18 bose] [--quiet] [--ui]
19
20 Flags:
21 --overwrite
22 Allow output files to overwrite existing files
23
24 --help
25 Print usage summary
26
27 --verbose
28 Verbose module output
29
30 --quiet
31 Quiet module output
32
33 --ui
34 Force launching GUI dialog
35
36 Parameters:
37 input=name [required]
38 Name of the input space time raster dataset
39
40 output=name [required]
41 Name of a space time raster dataset archive
42
43 directory=name
44 Path to the work directory, default is /tmp
45 Default: /tmp
46
47 compression=string
48 Compression method of the tar archive
49 Options: no, gzip, bzip2
50 Default: bzip2
51
52 format=string
53 The export format of a single raster map
54 Supported are GTiff, AAIGrid via r.out.gdal and the GRASS package
55 format of r.pack
56 Options: GTiff, AAIGrid, pack
57 Default: GTiff
58
59 type=string
60 Data type
61 Supported only for GTiff
62 Options: Byte, Int16, UInt16, Int32, UInt32, Float32, Float64,
63 CInt16, CInt32, CFloat32, CFloat64
64
65 createopt=string[,string,...]
66 Creation option(s) to pass to the output format driver
67 In the form of "NAME=VALUE", separate multiple entries with a comma
68
69 metaopt=string[,string,...]
70 Metadata key(s) and value(s) to include
71 In the form of "META-TAG=VALUE", separate multiple entries with a
72 comma. Not supported by all output format drivers.
73
74 nodata=float
75 Assign a specified nodata value to output bands
76 If given, the nodata value is always written to metadata even if
77 there are no NULL cells in the input band (enhances output compati‐
78 bility).
79
80 where=sql_query
81 WHERE conditions of SQL statement without ’where’ keyword used in
82 the temporal GIS framework
83 Example: start_time > ’2001-01-01 12:30:00’
84
86 t.rast.export exports a space time raster dataset (strds) as a tar ar‐
87 chive. The archive contains the raster maps either as GeoTIFF files or
88 as GRASS binary files exported using r.pack. The map specific color
89 tables are exported in case of GeoTIFF files. In addition several meta‐
90 data files are created in the archive that describe the temporal lay‐
91 out. All time stamps are stored in the file "list.txt", for each map
92 one row. The name of the map, the start time and the end time are writ‐
93 ten. In case of a time instance, the start time is equal to the end
94 time. The "init.txt" file stores the temporal type, the number of maps,
95 the chosen export format and some other metadata. The "proj.txt" file
96 stores the projection information as a proj4 string of the location the
97 space time raster dataset was exported from. The file "readme.txt"
98 describes the file format. The output of r.info for each raster map in
99 the space time dataset is stored in "metadata.txt".
100
101 The tar archive can be compressed using the compress option. Gzip and
102 bzip2 (default) are available. A where option can be specified, to
103 export only a subset of the space time dataset. Archives exported with
104 t.rast.export can be imported with t.rast.import.
105
107 The name of output file has to carry the suffix of the archive type,
108 the following suffix can be used:
109
110 · .tar in the case of compress=no
111
112 · .tar.bzip2 in the case of compress=bzip2
113
114 · .tar.gzip in the case of compress=gzip
115
117 In this example, all the raster maps of 2012 of "tempmean_monthly" will
118 be exported:
119 t.rast.export input=tempmean_monthly output=tempmean_monthly.tar.bzip2 \
120 where="start_time >= ’2012-01-01’ and start_time < ’2013-01-01’"
121 tar xvjf precipitation_daily.tar.bzip2
122 2012_01_tempmean.tif
123 2012_01_tempmean.color
124 2012_02_tempmean.tif
125 2012_02_tempmean.color
126 2012_03_tempmean.tif
127 2012_03_tempmean.color
128 2012_04_tempmean.tif
129 2012_04_tempmean.color
130 2012_05_tempmean.tif
131 2012_05_tempmean.color
132 2012_06_tempmean.tif
133 2012_06_tempmean.color
134 2012_07_tempmean.tif
135 2012_07_tempmean.color
136 2012_08_tempmean.tif
137 2012_08_tempmean.color
138 2012_09_tempmean.tif
139 2012_09_tempmean.color
140 2012_10_tempmean.tif
141 2012_10_tempmean.color
142 2012_11_tempmean.tif
143 2012_11_tempmean.color
144 2012_12_tempmean.tif
145 2012_12_tempmean.color
146 list.txt
147 proj.txt
148 init.txt
149 readme.txt
150 metadata.txt
151 cat init.txt
152 stds_type=strds
153 format=GTiff
154 temporal_type=absolute
155 semantic_type=mean
156 number_of_maps=48
157 north=320000.0
158 south=10000.0
159 east=935000.0
160 west=120000.0
161 cat proj.txt
162 +proj=lcc
163 +lat_1=36.16666666666666
164 +lat_2=34.33333333333334
165 +lat_0=33.75
166 +lon_0=-79
167 +x_0=609601.22
168 +y_0=0
169 +no_defs
170 +a=6378137
171 +rf=298.257222101
172 +towgs84=0.000,0.000,0.000
173 +to_meter=1
174 cat list.txt
175 2012_01_tempmean|2012-01-01 00:00:00|2012-02-01 00:00:00
176 2012_02_tempmean|2012-02-01 00:00:00|2012-03-01 00:00:00
177 2012_03_tempmean|2012-03-01 00:00:00|2012-04-01 00:00:00
178 2012_04_tempmean|2012-04-01 00:00:00|2012-05-01 00:00:00
179 2012_05_tempmean|2012-05-01 00:00:00|2012-06-01 00:00:00
180 2012_06_tempmean|2012-06-01 00:00:00|2012-07-01 00:00:00
181 2012_07_tempmean|2012-07-01 00:00:00|2012-08-01 00:00:00
182 2012_08_tempmean|2012-08-01 00:00:00|2012-09-01 00:00:00
183 2012_09_tempmean|2012-09-01 00:00:00|2012-10-01 00:00:00
184 2012_10_tempmean|2012-10-01 00:00:00|2012-11-01 00:00:00
185 2012_11_tempmean|2012-11-01 00:00:00|2012-12-01 00:00:00
186 2012_12_tempmean|2012-12-01 00:00:00|2013-01-01 00:00:00
187 cat readme.txt
188 This space time raster dataset was exported with t.rast.export of GRASS GIS 7
189 Files:
190 *.tif -- GeoTIFF raster files
191 *.color -- GRASS GIS raster color rules
192 proj.txt -- Projection information in PROJ format
193 init.txt -- GRASS GIS space time raster dataset information
194 list.txt -- Time series file, lists all maps by name with interval
195 time stamps in ISO-Format. Field separator is |
196 metadata.txt -- The output of t.info
197 readme.txt -- This file
198
200 t.rast.import, t.create, t.info, r.out.gdal, r.pack, t.vect.export
201
203 Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
204
206 Available at: t.rast.export source code (history)
207
208 Main index | Temporal index | Topics index | Keywords index | Graphical
209 index | Full index
210
211 © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
212
213
214
215GRASS 7.8.5 t.rast.export(1)