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

       Last changed: $Date: 2014-12-12 00:12:46 +0100 (Fri, 12 Dec 2014) $

SOURCE CODE

       Available at: r3.mkdspf source code (history)

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

       © 2003-2018 GRASS Development Team, GRASS GIS 7.4.0 Reference Manual