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)

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

       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual