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

NAME

6       t.vect.export   - Exports a space time vector dataset as GRASS GIS spe‐
7       cific archive file.
8

KEYWORDS

10       temporal, export, vector, time
11

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLE

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

SEE ALSO

166        t.vect.import, t.create, t.info, v.out.ogr, v.unpack, t.rast.export
167

AUTHOR

169       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
170

SOURCE CODE

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)
Impressum