1r3.mkdspf(1)                GRASS GIS User's Manual               r3.mkdspf(1)
2
3
4

NAME

6       r3.mkdspf   - Creates a display file from an existing 3D raster map ac‐
7       cording to specified threshold levels.
8

KEYWORDS

10       raster3d, display, voxel
11

SYNOPSIS

13       r3.mkdspf
14       r3.mkdspf --help
15       r3.mkdspf  [-qf]  input=string  dspf=name    [levels=float[,float,...]]
16       [min=float]    [max=float]    [step=float]    [tnum=integer]   [--over‐
17       write]  [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       -q
21           Suppress progress report & min/max information
22
23       -f
24           Use flat shading rather than gradient
25
26       --overwrite
27           Allow output files to overwrite existing files
28
29       --help
30           Print usage summary
31
32       --verbose
33           Verbose module output
34
35       --quiet
36           Quiet module output
37
38       --ui
39           Force launching GUI dialog
40
41   Parameters:
42       input=string [required]
43           Name of an existing 3D raster map
44
45       dspf=name [required]
46           Name for output display file
47
48       levels=float[,float,...]
49           List of thresholds for isosurfaces
50
51       min=float
52           Minimum isosurface level
53
54       max=float
55           Maximum isosurface level
56
57       step=float
58           Positive increment between isosurface levels
59
60       tnum=integer
61           Number of isosurface threshold levels
62           Default: 7
63

DESCRIPTION

65       Creates a display file from an existing grid3 file according to  speci‐
66       fied  threshold levels.  The display file is a display list of polygons
67       that represent isosurfaces of the data volume.  If specific levels  are
68       given,  additional  optional parameters are ignored.  Min or max may be
69       used alone or together to specify a sub-range of the  data.   The  step
70       parameter is given precedence over tnum.
71
72   Flags:
73       -q
74           Suppress progress report & min/max information
75
76       -f
77           Use flat shading rather than gradient
78
79   Parameters:
80       grid3
81           Name of an existing 3D raster map
82
83       dspf
84           Name of output display file
85
86       levels
87           List of thresholds for isosurfaces
88
89       min
90           Minimum isosurface level
91
92       max
93           Maximum isosurface level
94
95       step
96           Positive increment between isosurface levels
97
98       tnum
99           Number of isosurface threshold levels
100           Default: 7
101

NOTES

103       Currently the grid3 file must be in the user’s mapset since the display
104       files being created are specific to particular grid3 files and are con‐
105       tained  in  directories under them.  We should create a mechanism where
106       users may make display files from others’ grid3 files without having to
107       copy them to their mapset.
108

EXAMPLES

110       With  grid3 data (phdata) in the range 3-7, we only want to see isosur‐
111       face values for the range 4-6.  Any of these commands will produce  the
112       same results:
113       r3.mkdspf phdata dspf=iso min=4.0 max=6.0 tnum=5
114       r3.mkdspf phdata dspf=iso levels=4.0,4.5,5.0,5.5,6.0
115       r3.mkdspf phdata dspf=iso min=4.0 max=6.0 step=0.5
116

AUTHOR

118       Bill Brown, bbrown@gis.uiuc.edu
119

SOURCE CODE

121       Available at: r3.mkdspf source code (history)
122
123       Accessed: Saturday Jan 21 21:15:48 2023
124
125       Main  index | 3D raster index | Topics index | Keywords index | Graphi‐
126       cal index | Full index
127
128       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
129
130
131
132GRASS 8.2.1                                                       r3.mkdspf(1)