Debian Codegraph @

raster3d/r3.mkdspf/r3.mkdspf.html

raw
1 <h2>DESCRIPTION</h2>
2
3 Creates a display file from an existing grid3 file according to
4 specified threshold levels. The display file is a display list
5 of polygons that represent isosurfaces of the data volume. If
6 specific <em>levels</em> are given, additional optional parameters
7 are ignored. <em>Min</em> or <em>max</em> may be used alone or together
8 to specify a sub-range of the data. The <em>step</em>
9 parameter is given precedence over <em>tnum</em>.
10
11 <h3>Flags:</h3>
12 <dl>
13 <dt><b>-q</b>
14 <dd>Suppress progress report &amp; min/max information
15
16 <dt><b>-f</b>
17 <dd>Use flat shading rather than gradient
18 </dl>
19
20 <h3>Parameters:</h3>
21 <dl>
22 <dt><b>grid3</b>
23 <dd>Name of an existing 3D raster map
24
25 <dt><b>dspf</b>
26 <dd>Name of output display file
27
28 <dt><b>levels</b>
29 <dd>List of thresholds for isosurfaces
30
31 <dt><b>min</b>
32 <dd>Minimum isosurface level
33
34 <dt><b>max</b>
35 <dd>Maximum isosurface level
36
37 <dt><b>step</b>
38 <dd>Positive increment between isosurface levels
39
40 <dt><b>tnum</b>
41 <dd>Number of isosurface threshold levels
42 <dd>Default: 7
43 </dl>
44
45 <h2>NOTES</h2>
46
47 Currently the grid3 file must be in the user's mapset since the
48 display files being created are specific to particular grid3
49 files and are contained in directories under them.
50 We should create a mechanism where users
51 may make display files from others' grid3 files without having to
52 copy them to their mapset.
53
54 <h2>EXAMPLES</h2>
55
56 With grid3 data (<em>phdata</em>) in the range 3-7,
57 we only want to see isosurface values for the range 4-6.
58 Any of these commands will produce the same results:<br>
59 <div class="code"><pre>
60 r3.mkdspf phdata dspf=iso min=4.0 max=6.0 tnum=5
61 r3.mkdspf phdata dspf=iso levels=4.0,4.5,5.0,5.5,6.0
62 r3.mkdspf phdata dspf=iso min=4.0 max=6.0 step=0.5
63 </pre></div>
64
65 <h2>AUTHOR</h2>
66
67 Bill Brown, <a href="mailto:[email protected]">[email protected]</a>