r3.mkdspf(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

✨ r3.mkdspf ✨

okay bestie, welcome to r3.mkdspf, from the GRASS GIS User's Manual 💅 this is a raster3d / display / voxel girlie, and she's here to make you a display file out of a 3D raster map based on threshold levels you pick. no cap.

🌸 NAME 🌸

r3.mkdspf — creates a display file from an existing 3D raster map according to specified threshold levels. literally that's the whole job 🫶

🎀 KEYWORDS 🎀

raster3d, display, voxel

✨ SYNOPSIS ✨

r3.mkdspf
r3.mkdspf --help
r3.mkdspf [-qf] input=string dspf=name  [levels=float[,float,...]]
[levels=float[,float,...]] [min=float]   [max=float]   [step=float]
[tnum=integer]
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

okay wait, let me give you the exact synopsis, no edits, no vibes-corruption:

r3.mkdspf
r3.mkdspf --help
r3.mkdspf [-qf] input=string dspf=name  [levels=float[,float,...]]
[min=float]   [max=float]   [step=float]   [tnum=integer]
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🌈 Flags:

  • -q — shhh mode. suppresses the progress report & the min/max information 🤫
  • -f — flat shading instead of gradient, if you're feeling minimal 🎨
  • --overwrite — lets output files overwrite files that already exist (she will absolutely bulldoze them, so be careful bestie)
  • --help — prints the usage summary
  • --verbose — verbose module output, she tells you everything 💬
  • --quiet — quiet module output
  • --ui — forces launching the GUI dialog 🖥️

🦋 Parameters:

  • input=string [required] — name of an existing 3D raster map
  • dspf=name [required] — name for the output display file
  • levels=float[,float,...] — list of thresholds for isosurfaces
  • min=float — minimum isosurface level
  • max=float — maximum isosurface level
  • step=float — positive increment between isosurface levels
  • tnum=integer — number of isosurface threshold levels
    • Default: 7

💖 DESCRIPTION 💖

so here's the tea ☕ she creates a display file from an existing grid3 file according to specified threshold levels. that display file? it's a display list of polygons that represent isosurfaces of the data volume. iconic behavior tbh.

if specific levels are given, the additional optional parameters are ignored — she's already made up her mind, periodt. min or max may be used alone or together to specify a sub-range of the data. and the step parameter is given precedence over tnum. iykyk.

💜 Flags:

  • -q — suppress progress report & min/max information
  • -f — use flat shading rather than gradient

💜 Parameters:

  • grid3 — name of an existing 3D raster map
  • dspf — name of output display file
  • levels — list of thresholds for isosurfaces
  • min — minimum isosurface level
  • max — maximum isosurface level
  • step — positive increment between isosurface levels
  • tnum — number of isosurface threshold levels
    • Default: 7

🌟 NOTES 🌟

real talk: currently the grid3 file must be in the user's mapset, because the display files being created are specific to particular grid3 files and are contained in directories under them. 😭

and like, the manpage itself says out loud: we should create a mechanism where users may make display files from others' grid3 files without having to copy them to their mapset. so yeah, that's a known wish-list thing, not a thing you can do yet. noted 💀

🍓 EXAMPLES 🍓

say you've got grid3 data (phdata) in the range 3-7, and you only want to see isosurface values for the range 4-6. any of these commands will produce the same results 👑:

r3.mkdspf phdata dspf=iso min=4.0 max=6.0 tnum=5
r3.mkdspf phdata dspf=iso levels=4.0,4.5,5.0,5.5,6.0
r3.mkdspf phdata dspf=iso min=4.0 max=6.0 step=0.5

three different roads, same destination. slay ✨

💜 AUTHOR 💜

Bill Brown, bbrown@gis.uiuc.edu

🧚 SOURCE CODE 🧚

Available at: r3.mkdspf source code (history)

Accessed: Saturday Jan 17 05:41:16 2026

Main index | 3D raster 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, page r3.mkdspf(1), last touched by the docs at Saturday Jan 17 05:41:16 2026 — go make some isosurfaces, you're gonna eat 💅🌟

📦 where this page comes from