t.rast.import(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 t.rast.import — the GRASS GIS manual, but make it slay 💖

okay so bestie, you know how we're always like "I exported my space time raster dataset and now what"?? Well. This is the what. This is the t.rast.import page from the GRASS GIS User's Manual, and I'm gonna walk you through it like we're texting at 2am. No gatekeeping. Periodt. ✨

🌸 NAME 🌸

t.rast.import — imports space time raster dataset. that's it. that's the whole vibe. it brings your STRDS home. 🏠💫

🎀 KEYWORDS 🎀

temporal, import, raster, time, create project

(iykyk — these are the lil tags that help you find this page when you're lost in the docs at 3am)

✨ SYNOPSIS ✨

t.rast.import
t.rast.import --help
t.rast.import [-rleoc] input=name output=name  [basename=string]
directory=name  [title=string]   [description=string]   [project=string]
[memory=memory in MB]   [--overwrite]  [--help]  [--verbose]  [--quiet]
[--ui]

like. look at her. the flags are all bunched up in [-rleoc] and she is thriving. 💅

🧚 Flags:

  • -r — Set the current region from the last map that was imported. so whatever got imported last? yeah, the region follows it. main character behavior fr.
  • -l — Link the raster files using r.external. linking instead of copying, we love a low-effort queen. 🔗
  • -e — Extend project extents based on new dataset. stretch that canvas bestie, the data's bigger than you thought. 🦋
  • -o — Override projection check (use current projects's CRS). Assume that the dataset has same coordinate reference system as the current location. > ⚠️ this is you telling it to trust you. it does not verify. so only do this if you actually know, okay? 😭
  • -c — Create the project specified by the "project" parameter and exit. Do not import the space time raster datasets. like, you're just building the container and dipping. bye! 👋
  • --overwrite — Allow output files to overwrite existing files. dangerous girlboss move, use with intention. 💀
  • --help — Print usage summary. your bestie when you forget everything.
  • --verbose — Verbose module output. she talks a LOT. we love her for it.
  • --quiet — Quiet module output. she says nothing. also iconic.
  • --ui — Force launching GUI dialog. pop-up era. 🪟

🌈 Parameters:

  • input=name [required] — Name of input file. required required. can't skip her.
  • output=name [required] — Name of the output space time raster dataset. also required, also can't skip.
  • basename=string — Basename of the new generated output maps. A numerical suffix separated by an underscore will be attached to create a unique identifier. so like, lst becomes lst_1, lst_2, etc. cute lil numbering system 🍓
  • directory=name [required] — Path to the extraction directory. Default: /tmp
  • title=string — Title of the new space time dataset. give her a name, she deserves it.
  • description=string — Description of the new space time dataset. the lil bio. 📝
  • project=string — Create a new project and import the data into it. > ⚠️ Do not run this module in parallel or interrupt it when a new project should be created. like genuinely do not. let her cook. 🍳
  • memory=memory in MB — Maximum memory to be used (in MB). Cache size for raster rows. Default: 300

💜 DESCRIPTION 💜

t.rast.import imports a space time raster dataset archive that was exported with t.rast.export. that's it, that's the plot. export → import. the circle of life. 🦁🌅

🫶 NOTES 🫶

Optionally a base map name can be provided to avoid that existing raster maps are overwritten by the map names that are used in the STRDS archive. (so like — if the archive has map names that would clobber your existing maps, you can give a base name and dodge the whole situation. protect your babies.)

The directory is used as work directory in case of import but can also be used as a data directory when using GeoTIFF for the data exchange. (dual purpose directory, she contains multitudes.) ✨

🌟 EXAMPLE 🌟

The North Carolina space time dataset contains a data package called lst_daily.tar.bzip2 with daily data from MODIS LST. Import it by running:

t.rast.import input=lst_daily.tar.bzip2 output=lst_daily \
              basename=lst directory=/tmp

and boom. imported. you ate. 🔥

👑 SEE ALSO 👑

t.rast.export, t.create, t.info, r.in.gdal, r.unpack, t.vect.import

(the whole friend group. go say hi.)

🎀 AUTHOR 🎀

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

thank you for your service king 🫡

🌸 SOURCE CODE 🌸

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

Accessed: Saturday Jan 17 05:41:53 2026

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

and that's the page bestie!! 💖 this whole thing came to you courtesy of the GRASS Development Team, © 2003-2025, running on GRASS GIS 8.4.2 Reference Manual, and honestly? it's giving legendary. this footer was proudly stamped on t.rast.import(1) by GRASS 8.4.2 itself. go import something gorgeous. 🌈✨💅

📦 where this page comes from