r3.mkdspf - GRASS GIS manual
Author: GRASS Development Team
Description: r3.mkdspf: Creates a display file from an existing 3D raster map according to specified threshold levels.
Keywords: raster3d, display, voxel

## 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

## Example:

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

## NOTE

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.

## AUTHOR

Bill Brown, bbrown@gis.uiuc.edu

## SOURCE CODE

Available at: r3.mkdspf source code (history)

Accessed: Sunday Jun 21 00:54:33 2026

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

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.8 Reference Manual