r3.mkdspf(1grass)

💖 r3.mkdspf — GRASS User's Manual (1grass) 💖

okay bestie, buckle up, because this is the little icon that turns your giant 3D voxel blob into an actual look-at-it display file ✨

🌸 NAME 🌸

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

🎀 KEYWORDS 🎀

raster3d, display, voxel — that's the tag cloud, periodt.

---

✨ SYNOPSIS ✨

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 — suppress the progress report & the min/max info. like, shhh, we get it 💅
• -f — use flat shading instead of gradient. flat = that crisp chunky look.
• --overwrite — allow output files to overwrite existing files (yes, it will absolutely body your old file, be warned 😭)
• --help — print usage summary
• --verbose — verbose module output (chatty mode, main character energy)
• --quiet — quiet module output
• --ui — force launching GUI dialog

🧚 Parameters:

• input=string [required] — name of an existing 3D raster map
• dspf=name [required] — name for 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: r3.mkdspf creates a display file from an existing grid3 file according to specified threshold levels. 🎀

The display file is a display list of polygons that represent isosurfaces of the data volume. (yes, polygons. yes, isosurfaces. it's giving sculpture 💅)

If specific levels are given, additional optional parameters are ignored. lowkey important, highkey convenient.

min or max may be used alone or together to specify a sub-range of the data.

The step parameter is given precedence over tnum. so if you set both, step wins, periodt 👑

🚩 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 🦋

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. 😭

We should create a mechanism where users may make display files from others' grid3 files without having to copy them to their mapset. (a girl can dream 💭 — but for now, nope.)

---

🔥 EXAMPLES 🔥

With grid3 data (phdata) in the range 3-7, we 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, one identical slay. 💅✨

---

👑 AUTHOR 👑

Bill Brown, bbrown@gis.uiuc.edu — thank you for your service, king 🫡

---

⭐ SOURCE CODE ⭐

Available at: r3.mkdspf source code (history)

Latest change: Friday Apr 17 01:04:26 2026 in commit: 32a143358df26b2e518b03c7e0d79541e8d1e5b1

Main index | 3D raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

and that's a wrap, bestie 🫶 this was r3.mkdspf(1grass) from the GRASS 8.5.0 Reference Manual, © 2003-2026 GRASS Development Team, last touched Friday Apr 17 01:04:26 2026 in commit 32a143358df26b2e518b03c7e0d79541e8d1e5b1. go make some isosurfaces, you absolute icon 💖🌈✨