t.rast3d.extract(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

✨ t.rast3d.extract ✨

okay bestie, we're in the GRASS GIS User's Manual and today's main character is t.rast3d.extract 💅 it's a command-line module, so it's giving t.rast3d.extract(1) energy — section 1, terminal girlie, no GUI required (unless you want one, we'll get there).

💖 NAME 💖

t.rast3d.extract — extracts a subset of a space time 3D raster dataset. literally just vibes-slicing your voxel data, no cap 🎀

🌸 KEYWORDS 🌸

temporal, extract, raster3d, voxel, time

(iykyk — if you know, you know 🦋)

⭐ SYNOPSIS ⭐

t.rast3d.extract
t.rast3d.extract --help
t.rast3d.extract [-n] input=name  [where=sql_query]
[expression=string]  output=name  [basename=string]   [suffix=string]
[nprocs=integer]   [--overwrite]  [--help]  [--verbose]  [--quiet]
[--ui]

🚩 Flags 🚩

  • -n — register Null maps. yes bestie, the null maps are getting an invite too 🙈
  • --overwrite — allow output files to overwrite existing files. chaotic but permitted 💀
  • --help — print usage summary. your emotional support flag 🫶
  • --verbose — verbose module output. she's chatty and we love that for her ✨
  • --quiet — quiet module output. shhh, she's in her silent era 🤫
  • --ui — force launching GUI dialog. for when the terminal isn't enough and you need to see her 👑

🎀 Parameters 🎀

  • input=name [required] — name of the input space time raster3d dataset. the source material, the blueprint, the moment 🌈
  • where=sql_query — WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework. Example: start_time > '2001-01-01 12:30:00' — so you can be like "bestie, only after this exact moment please" ⏰
  • expression=string — the r3.mapcalc expression assigned to all extracted 3D raster maps. math but make it fashion 🧮💅
  • output=name [required] — name of the output space time raster3d dataset. the new girl in town, the glow-up destination 💖
  • basename=string — basename of the new generated 3D raster maps. she needs a name, obviously 🎀
  • suffix=string — suffix to add at basename: set gran for granularity, time for the full time format, num for numerical suffix with a specific number of digits (default %05). Default: gran — pick your accessory, they all slay 🌸
  • nprocs=integer — number of r3.mapcalc processes to run in parallel. Default: 1 — one process is lowkey cozy but you can absolutely assemble a whole girl squad 🔥

💜 DESCRIPTION 💜

So t.rast3d.extract is used to extract a subset of a space time 3D raster dataset and to store that subset in a different space time 3D raster dataset. it's basically the "save a copy of just this part" button but for voxels 👑

It has exactly the same functionality as t.rast.extract. the only difference is the that this module works on STR3DS and 3D raster maps. that's it. that's the whole plot twist 🦋

Please refer to t.rast.extract for documentation and examples. bestie, go read that one, it's the sister module and she's carrying all the lore 📖

🔗 SEE ALSO 🔗

  • t.rast.extract
  • t.create
  • t.info

👑 AUTHOR 👑

Sören Gebbert, Thünen Institute of Climate-Smart Agriculture — thank you for your service, legend 🫶

💻 SOURCE CODE 💻

Available at: t.rast3d.extract source code (history)

Accessed: Saturday Jan 17 05:41:54 2026

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

okay that's the whole page, bestie, you ate 💅 and now the cute sign-off: this was GRASS GIS 8.4.2 Reference Manual, © 2003-2025 GRASS Development Team, running on GRASS 8.4.2 ✨ mwah, go extract something gorgeous 💖🎀🦋

📦 where this page comes from