1d.colortable(1)             GRASS GIS User's Manual            d.colortable(1)
2
3
4

NAME

6       d.colortable   -  Displays the color table associated with a raster map
7       layer.
8

KEYWORDS

10       display, raster, color table
11

SYNOPSIS

13       d.colortable
14       d.colortable --help
15       d.colortable  [-n]  map=name   [color=name]    [lines=integer]    [col‐
16       umns=integer]   [--help]  [--verbose]  [--quiet]  [--ui]
17
18   Flags:
19       -n
20           Do not draw a collar showing the NULL color in FP maps
21
22       --help
23           Print usage summary
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31       --ui
32           Force launching GUI dialog
33
34   Parameters:
35       map=name [required]
36           Name of raster map whose color table is to be displayed
37
38       color=name
39           Color of lines separating the colors of the color table
40           Either a standard color name or R:G:B triplet
41           Default: white
42
43       lines=integer
44           Number of lines to appear in the color table
45           Options: 1-1000
46
47       columns=integer
48           Number of columns to appear in the color table
49           Options: 1-1000
50

DESCRIPTION

52       d.colortable  is  used  to  display  the  color table associated with a
53       raster map in the active frame on the graphics monitor.  The  map  name
54       should  be  an available raster map in the user’s current mapset search
55       path and location.
56
57       If the values of both lines and columns are not specified by the  user,
58       d.colortable divides the active frame equally among the number of cate‐
59       gories present in the named raster map. If one option is specified, the
60       other  is automatically set to accommodate all categories.  If both are
61       specified, as many categories as possible are displayed.
62
63       If the user specifies the name of a map on the command  line  but  does
64       not  specify  the  values of other parameters, parameter default values
65       will be used.  Alternately, if the user types  simply  d.colortable  on
66       the command line without any program arguments, the program will prompt
67       the user for parameter settings using the standard GRASS parser  inter‐
68       face.
69

EXAMPLE

71       The user running the command:
72       d.colortable map=soils color=red lines=1 columns=3
73       would  see the active graphics frame divided into three columns extend‐
74       ing the full frame height. The lines dividing the color  table  associ‐
75       ated  with the soils map would be displayed in red. The user would see,
76       at most, only three of the colors from the soils color table  displayed
77       in  the  active  frame  (because  the user requested that this frame be
78       divided into three sections).
79

NOTES

81       If the user wishes to display the entire color table associated with  a
82       map, the user should either stipulate a number of lines (rows) and col‐
83       umns (cols) sufficient to accommodate the number of categories  in  the
84       map’s  color  table,  or  fail to assign values to one or both of lines
85       and/or columns.  If the user runs d.colortable using the default number
86       of lines and columns (the full graphics frame), all categories from the
87       map’s color table will be displayed. However, if the user requests that
88       the  color  table associated with a map which has 10 data categories be
89       displayed in a graphics frame with only 3 lines (rows) and 2 columns (a
90       total  of  six  cells), only six of the ten map categories will be dis‐
91       played.
92
93       The user should run d.erase between runs of d.colortable to avoid  con‐
94       fusion.
95

SEE ALSO

97        d.erase, d.legend, d.rast
98

AUTHOR

100       James  Westervelt,  U.S. Army Construction Engineering Research Labora‐
101       tory
102

SOURCE CODE

104       Available at: d.colortable source code (history)
105
106       Main index | Display index | Topics index | Keywords index |  Graphical
107       index | Full index
108
109       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
110
111
112
113GRASS 7.8.5                                                    d.colortable(1)
Impressum