Debian Codegraph @

display/d.colortable/d.colortable.html

raw
1 <h2>DESCRIPTION</h2>
2
3 <em>d.colortable</em> is used to display the color table associated
4 with a raster map in the active frame on the graphics
5 monitor. The <b>map</b> name should be an available raster map in the
6 user's current mapset search path and location.
7
8 <p>If the <em>values</em> of both <b>lines</b> and <b>columns</b> are
9 not specified by the user, <em>d.colortable</em> divides the active
10 frame equally among the number of categories present in the named
11 raster map. If one option is specified, the other is automatically set
12 to accommodate all categories. If both are specified, as many
13 categories as possible are displayed.
14
15 <p>If the user specifies the name of a map on the command line but does not
16 specify the values of other parameters, parameter default values will be used.
17 Alternately, if the user types simply <em>d.colortable</em> on the command line
18 without any program arguments, the program will prompt the user for parameter
19 settings using the standard GRASS parser interface.
20
21 <h2>EXAMPLE</h2>
22
23 The user running the command:
24
25 <div class="code"><pre>
26 d.colortable map=soils color=red lines=1 columns=3
27 </pre></div>
28
29 would see the active graphics frame divided into three columns
30 extending the full frame height. The lines dividing the color table
31 associated with the <em>soils</em> map would be displayed in red. The
32 user would see, at most, only three of the colors from
33 the <em>soils</em> color table displayed in the active frame (because
34 the user requested that this frame be divided into three sections).
35
36 <h2>NOTES</h2>
37
38 If the user wishes to display the entire color table associated with
39 a map, the user should either stipulate a number of lines (rows) and
40 columns (cols) sufficient to accommodate the number of categories
41 in the map's color table, or fail to assign values to one or both of
42 <b>lines</b> and/or <b>columns</b>.
43 If the user runs <em>d.colortable</em> using the default number of
44 lines and columns (the full graphics frame), all categories from the
45 map's color table will be displayed. However, if the user requests
46 that the color table associated with a map which has 10 data categories
47 be displayed in a graphics frame with only 3 lines (rows) and 2 columns
48 (a total of six cells),
49 only six of the ten map categories will be displayed.
50
51 <p>The user should run <em><a href="d.erase.html">d.erase</a></em>
52 between runs of <em>d.colortable</em> to avoid confusion.
53
54 <h2>SEE ALSO</h2>
55
56 <em>
57 <a href="d.erase.html">d.erase</a>,
58 <a href="d.legend.html">d.legend</a>,
59 <a href="d.rast.html">d.rast</a>
60 </em>
61
62 <h2>AUTHOR</h2>
63
64 James Westervelt, U.S. Army Construction Engineering Research Laboratory