r3.mkdspf(1)

NAME
r3.mkdspf - Creates a display file from an existing 3D raster map according to specified threshold levels.

KEYWORDS
raster3d, display, voxel

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 progress report & min/max information

-f
    Use flat shading rather than gradient

--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=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
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. If specific levels are given, additional optional parameters are ignored. 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.

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

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

AUTHOR
Bill Brown, bbrown@gis.uiuc.edu

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.1dev Reference Manual