t.vect.import(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 t.vect.import 💖

okay bestie, welcome to the GRASS GIS User's Manual entry for t.vect.import — she's a temporal, import, vector, time, create project girlie and she's here to move your space time vector datasets around. 🦋

✨ SYNOPSIS ✨

t.vect.import
t.vect.import --help
t.vect.import [-eoc] input=name output=name  [basename=string]
directory=name  [title=string]   [description=string]   [project=string]
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🎀 FLAGS 🎀

  • -e — Extend project extents based on new dataset
  • -o — Override projection check (use current projects's CRS). Assume that the dataset has same coordinate reference system as the current project
  • -c — Create the project specified by the "project" parameter and exit. Do not import the space time vector datasets.
  • --overwrite — Allow output files to overwrite existing files
  • --help — Print usage summary
  • --verbose — Verbose module output
  • --quiet — Quiet module output
  • --ui — Force launching GUI dialog

🌸 PARAMETERS 🌸

  • input=name [required] — Name of input file
  • output=name [required] — Name of the output space time vector dataset
  • basename=string — Basename of the new generated output maps. A numerical suffix separated by an underscore will be attached to create a unique identifier
  • directory=name [required] — Path to the extraction directory
  • title=string — Title of the new space time dataset
  • description=string — Description of the new space time dataset
  • project=string — Create a new project (location) and import the data into it. Do not run this module in parallel or interrupt it when a new project should be created
⚠️ heads up bestie: that project= one? Do not run this module in parallel or interrupt it when a new project should be created. she is not built for multitasking, fr fr. 💀

💅 DESCRIPTION 💅

t.vect.import imports a space time vector dataset archive that was exported with t.vect.export. that's it, that's the vibe. import → archive → slay ✨

🫶 NOTES 🫶

Optionally a base map name can be provided to avoid that existing vector maps are overwritten by the map names that are used in the STRDS archive.

The directory is used as work directory in case of import but can also be used as a data directory when using GML for the data exchange.

🌈 EXAMPLE 🌈

so in this example, five vector maps get created and registered in a single space time vector dataset named random_locations. Each vector map represents random locations within the boundary of the state taken at 1 month intervals. Then the space time dataset is exported and re-imported. iconic behavior, no notes. 💖

db.connect -d
for i in `seq 1 5` ; do
    v.random output=map_$i n=500 restrict=boundary_state@PERMANENT
    echo map_$i >> map_list.txt
done
t.create type=stvds temporaltype=absolute \
         output=random_locations \
         title="Random locations" \
         description="Vector test dataset with random locations"
t.register -i type=vector input=random_locations \
           file=map_list.txt start="2012-01-01" increment="1 months"
t.vect.list random_locations
t.vect.export input=random_locations output=random_locations.tar.gz \
              compression=gzip
t.vect.import input=random_locations.tar.gz output=new_random_locations \
              basename=new_map directory=/tmp
t.vect.list new_random_locations

and the output is giving:

id|name|layer|mapset|start_time|end_time
new_map_1@user1|new_map_1|None|user1|2012-01-01 00:00:00|2012-02-01 00:00:00
new_map_2@user1|new_map_2|None|user1|2012-02-01 00:00:00|2012-03-01 00:00:00
new_map_3@user1|new_map_3|None|user1|2012-03-01 00:00:00|2012-04-01 00:00:00
new_map_4@user1|new_map_4|None|user1|2012-04-01 00:00:00|2012-05-01 00:00:00
new_map_5@user1|new_map_5|None|user1|2012-05-01 00:00:00|2012-06-01 00:00:00

👑 SEE ALSO 👑

  • t.vect.export
  • t.create
  • t.info
  • v.in.ogr
  • v.pack
  • t.rast.import

⭐ AUTHOR ⭐

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

🧚 SOURCE CODE 🧚

Available at: t.vect.import source code (history)

Accessed: Saturday Jan 17 05:41:54 2026

Main index | Temporal index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

and that's the whole page, bestie!! 🌈✨ this was GRASS 8.4.2 serving t.vect.import(1) energy — go import something gorgeous, ily, mwah 💖🎀🦋

📦 where this page comes from