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