1t.rast.export(1)              Grass User's Manual             t.rast.export(1)
2
3
4

NAME

6       t.rast.export  - Exports space time raster dataset.
7

KEYWORDS

9       temporal, export, raster, time
10

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLE

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.4 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

SEE ALSO

200        t.rast.import, t.create, t.info, r.out.gdal, r.pack, t.vect.export
201

AUTHOR

203       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
204

SOURCE CODE

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-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
212
213
214
215GRASS 7.8.2                                                   t.rast.export(1)
Impressum