← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to display/d.colortable/d.colortable.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
display/d.colortable/d.colortable.html
 
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
 
65
 
 
66
<p>
 
67
<i>Last changed: $Date: 2015-02-02 09:13:36 +0100 (Mon, 02 Feb 2015) $</i>