r3.mkdspf(1grass)

r3.mkdspf1grass

Creates a display file from an existing 3d raster map according to specified threshold levels.

Usage

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]

Keywords

raster3d, display, voxel

Overview

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

Source code

Available at: r3.mkdspf source code (history)

Accessed: Monday Feb 24 17:51:08 2025

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual

Releases

10 releases since Debian 4.0 (Etch); the text changed 9 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12
  10. 13

Author

Bill Brown, [email protected]

From grass-doc 8.4.1-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.