| 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 |