1t.vect.export(1) Grass User's Manual t.vect.export(1)
2
3
4
6 t.vect.export - Exports a space time vector dataset as GRASS GIS spe‐
7 cific archive file.
8
10 temporal, export, vector, time
11
13 t.vect.export
14 t.vect.export --help
15 t.vect.export input=name output=name [directory=name] [compres‐
16 sion=string] [format=string] [where=sql_query] [--overwrite]
17 [--help] [--verbose] [--quiet] [--ui]
18
19 Flags:
20 --overwrite
21 Allow output files to overwrite existing files
22
23 --help
24 Print usage summary
25
26 --verbose
27 Verbose module output
28
29 --quiet
30 Quiet module output
31
32 --ui
33 Force launching GUI dialog
34
35 Parameters:
36 input=name [required]
37 Name of the input space time vector dataset
38
39 output=name [required]
40 Name of a space time vector dataset archive
41
42 directory=name
43 Path to the work directory, default is /tmp
44 Default: /tmp
45
46 compression=string
47 Compression method of the tar archive
48 Options: no, gzip, bzip2
49 Default: bzip2
50
51 format=string
52 The export format of a single vector map
53 Supported are GML and GPKG via v.out.ogr and the GRASS package for‐
54 mat of v.pack
55 Options: GML, GPKG, pack
56 Default: GML
57
58 where=sql_query
59 WHERE conditions of SQL statement without ’where’ keyword used in
60 the temporal GIS framework
61 Example: start_time > ’2001-01-01 12:30:00’
62
64 t.vect.export exports a space time vector dataset (stvds) to a tar ar‐
65 chive as either GML (using v.out.ogr) or GRASS pack files. In addition
66 to the pack or GML files, several metadata files are also created in
67 the archive that describe the temporal layout. All time stamps are
68 stored in the file "list.txt", for each map one row. The name of the
69 map, the start time and the end time are written. In case of a time
70 instance, the start time is equal to the end time. The "init.txt" file
71 stores the temporal type, the number of maps, the chosen export format
72 and some other metadata. The "proj.txt" file stores the projection
73 information as a proj4 string of the location the space time vector
74 dataset was exported from. The file "readme.txt" describes the file
75 format. The output of v.info for each vector map in the space time
76 dataset is stored in "metadata.txt".
77
78 The tar archive can be compressed using the compress option. Gzip and
79 bzip2 (default) are available. A where option can be specified, to
80 export only a subset of the space time dataset. Archives exported with
81 t.vect.export can be imported with t.vect.import.
82
84 The name of output file has to carry the suffix of the archive type,
85 the following suffix can be used:
86
87 · .tar in the case of compress=no
88
89 · .tar.bzip2 in the case of compress=bzip2
90
91 · .tar.gzip in the case of compress=gzip
92
94 In this example, five vector maps are created and registered in a sin‐
95 gle space time vector dataset named random_locations. Each vector map
96 represents random locations within the boundary of the state taken at 1
97 month intervals.
98 t.vect.export input=shoreline output=shoreline_nc.tar.bzip2
99 tar xvfj shoreline_nc.tar.bzip2
100 shoreline_1849_1873.xml
101 shoreline_1849_1873.xsd
102 shoreline_1925_1946.xml
103 shoreline_1925_1946.xsd
104 shoreline_1970_1988.xml
105 shoreline_1970_1988.xsd
106 shoreline_1997.xml
107 shoreline_1997.xsd
108 shoreline_1998.xml
109 shoreline_1998.xsd
110 shoreline_2003.xml
111 shoreline_2003.xsd
112 shoreline_2004.xml
113 shoreline_2004.xsd
114 shoreline_2009.xml
115 shoreline_2009.xsd
116 list.txt
117 proj.txt
118 init.txt
119 readme.txt
120 metadata.txt
121 cat init.txt
122 stds_type=stvds
123 format=GML
124 temporal_type=relative
125 semantic_type=mean
126 relative_time_unit=years
127 number_of_maps=8
128 north=1039175.31479
129 south=9403.301982
130 east=3052352.00337
131 west=651481.84739
132 cat proj.txt
133 +proj=lcc
134 +lat_1=36.16666666666666
135 +lat_2=34.33333333333334
136 +lat_0=33.75
137 +lon_0=-79
138 +x_0=609601.22
139 +y_0=0
140 +no_defs
141 +a=6378137
142 +rf=298.257222101
143 +towgs84=0.000,0.000,0.000
144 +to_meter=1
145 cat list.txt
146 shoreline_1849_1873|1849|1873
147 shoreline_1925_1946|1925|1946
148 shoreline_1970_1988|1970|1988
149 shoreline_1997|1997|1997
150 shoreline_1998|1998|1998
151 shoreline_2003|2003|2003
152 shoreline_2004|2004|2004
153 shoreline_2009|2009|2009
154 cat readme.txt
155 This space time vector dataset was exported with t.vect.export of GRASS GIS 7
156 Files:
157 *.xml -- Vector GML files
158 proj.txt -- Projection information in PROJ.4 format
159 init.txt -- GRASS GIS space time vector dataset information
160 list.txt -- Time series file, lists all maps by name with interval
161 time stamps in ISO-Format. Field separator is |
162 metadata.txt -- The output of t.info
163 readme.txt -- This file
164
166 t.vect.import, t.create, t.info, v.out.ogr, v.unpack, t.rast.export
167
169 Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
170
172 Available at: t.vect.export source code (history)
173
174 Main index | Temporal index | Topics index | Keywords index | Graphical
175 index | Full index
176
177 © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
178
179
180
181GRASS 7.8.2 t.vect.export(1)