dwww Home | Manual pages | Find package

r3.mkdspf(1grass)           GRASS GIS User's Manual          r3.mkdspf(1grass)

NAME
       r3.mkdspf   - Creates a display file from an existing 3D raster map ac-
       cording 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]   [--over-
       write]  [--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  speci-
       fied  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 isosur-
       face 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 con-
       tained  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: unknown

       Main  index | 3D raster index | Topics index | Keywords index | Graphi-
       cal index | Full index

       © 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual

GRASS 7.8.7                                                  r3.mkdspf(1grass)

Generated by dwww version 1.14 on Fri Jan 24 09:46:35 CET 2025.