1t.vect.import(1)            GRASS GIS User's Manual           t.vect.import(1)
2
3
4

NAME

6       t.vect.import   -  Imports a space time vector dataset from a GRASS GIS
7       specific archive file.
8

KEYWORDS

10       temporal, import, vector, time, create location
11

SYNOPSIS

13       t.vect.import
14       t.vect.import --help
15       t.vect.import [-eoc] input=name output=name  [basename=string]   direc‐
16       tory=name   [title=string]    [description=string]    [location=string]
17       [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       -e
21           Extend location extents based on new dataset
22
23       -o
24           Override projection check (use current location’s projection)
25           Assume that the dataset has same projection as the current location
26
27       -c
28           Create the location specified by the "location" parameter and exit.
29           Do not import the space time vector datasets.
30
31       --overwrite
32           Allow output files to overwrite existing files
33
34       --help
35           Print usage summary
36
37       --verbose
38           Verbose module output
39
40       --quiet
41           Quiet module output
42
43       --ui
44           Force launching GUI dialog
45
46   Parameters:
47       input=name [required]
48           Name of input file
49
50       output=name [required]
51           Name of the output space time vector dataset
52
53       basename=string
54           Basename of the new generated output maps
55           A  numerical  suffix separated by an underscore will be attached to
56           create a unique identifier
57
58       directory=name [required]
59           Path to the extraction directory
60
61       title=string
62           Title of the new space time dataset
63
64       description=string
65           Description of the new space time dataset
66
67       location=string
68           Create a new location and import the data into it. Do not run  this
69           module  in  parallel  or interrupt it when a new location should be
70           created
71

DESCRIPTION

73       t.vect.import imports a space time vector dataset archive that was  ex‐
74       ported with t.vect.export.
75

NOTES

77       Optionally  a base map name can be provided to avoid that existing vec‐
78       tor maps are overwritten by the map names that are used  in  the  STRDS
79       archive.
80
81       The  directory is used as work directory in case of import but can also
82       be used as a data directory when using GML for the data exchange.
83

EXAMPLE

85       In this example, five vector maps are created and registered in a  sin‐
86       gle  space  time vector dataset named random_locations. Each vector map
87       represents random locations within the boundary of the state taken at 1
88       month  intervals.   The  space time dataset is then exported and re-im‐
89       ported.
90       db.connect -d
91       for i in `seq 1 5` ; do
92           v.random output=map_$i n=500 restrict=boundary_state@PERMANENT
93           echo map_$i >> map_list.txt
94       done
95       t.create type=stvds temporaltype=absolute \
96                output=random_locations \
97                title="Random locations" \
98                description="Vector test dataset with random locations"
99       t.register -i type=vector input=random_locations \
100                  file=map_list.txt start="2012-01-01" increment="1 months"
101       t.vect.list random_locations
102       t.vect.export input=random_locations output=random_locations.tar.gz \
103                     compression=gzip
104       t.vect.import input=random_locations.tar.gz output=new_random_locations \
105                     basename=new_map directory=/tmp
106       t.vect.list new_random_locations
107       id|name|layer|mapset|start_time|end_time
108       new_map_1@user1|new_map_1|None|user1|2012-01-01 00:00:00|2012-02-01 00:00:00
109       new_map_2@user1|new_map_2|None|user1|2012-02-01 00:00:00|2012-03-01 00:00:00
110       new_map_3@user1|new_map_3|None|user1|2012-03-01 00:00:00|2012-04-01 00:00:00
111       new_map_4@user1|new_map_4|None|user1|2012-04-01 00:00:00|2012-05-01 00:00:00
112       new_map_5@user1|new_map_5|None|user1|2012-05-01 00:00:00|2012-06-01 00:00:00
113

SEE ALSO

115        t.vect.export, t.create, t.info, v.in.ogr, v.pack, t.rast.import
116

AUTHOR

118       Sören Gebbert, Thünen Institute of Climate-Smart Agriculture
119

SOURCE CODE

121       Available at: t.vect.import source code (history)
122
123       Accessed: Mon Jun 20 16:47:48 2022
124
125       Main index | Temporal index | Topics index | Keywords index | Graphical
126       index | Full index
127
128       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
129
130
131
132GRASS 8.2.0                                                   t.vect.import(1)
Impressum