1d.colortable(1) Grass User's Manual d.colortable(1)
2
6 d.colortable - Displays the color table associated with a raster map
7 layer.
8
10 display, setup
11
13 d.colortable
14 d.colortable help
15 d.colortable map=string [color=string] [lines=integer] [cols=inte‐
16 ger] [--verbose] [--quiet]
17 Parameters:
19 map=string
20 Name of existing raster map
21 color=string
23 Color of lines separating the colors of the color table
24 Options: red,orange,yellow,green,blue,indigo,vio‐
25 let,white,black,gray,brown,magenta,aqua,grey,cyan,purple
26 Default: black
27 lines=integer
29 Number of lines
30 Options: 1-1000
31 cols=integer
33 Number of columns
34 Options: 1-1000
35
37 The GRASS program d.colortable is used to display the color table asso‐
38 ciated with a raster map layer in the active frame on the graphics mon‐
39 itor. The map name should be an available raster map layer in the
40 user's current mapset search path and location.
41 Parameters:
43 map=name
44 Name of a raster map layer in the user's current mapset search
45 path whose color table is to be displayed.
46 color=name
48 Color of the lines separating the colors of the color table.
49 Options: red, orange, yellow, green, blue, indigo, violet, gray,
50 white, and black.
51 Default: white
52 lines=value
54 Number of lines to appear in the color table.
55 Options: 1 - 1000
56 cols=value
58 Number of columns to appear in the color table.
59 Options: 1 - 1000 If the values of both lines and cols are not
60 specified by the user, d.colortable divides the active frame
61 equally among the number of categories present in the named
62 raster map layer. If one option is specified, the other is auto‐
63 matically set to accommodate all categories. If both are speci‐
64 fied, as many categories as possible are displayed.
65 The user can specify all needed parameters on the command line using
67 the form:
68 d.colortable map=name [color=name] [lines=value] [cols=value]
70 If the user specifies the name of a map on the command line but does
72 not specify the values of other parameters, parameter default values
73 will be used. Alternately, if the user types simply d.colortable on
74 the command line without any program arguments, the program will prompt
75 the user for parameter settings using the standard GRASS parser inter‐
76 face described in the manual entry for parser.
77
79 The user running the command: d.colortable map=soils [color=red]
80 [lines=1] [cols=3]
81 would see the active graphics frame divided into three columns extend‐
83 ing the full frame height. The lines dividing the color table associ‐
84 ated with the soils map would be displayed in red. The user would see,
85 at most, only three of the colors from the soils color table displayed
86 in the active frame (because the user requested that this frame be
87 divided into three sections).
88
90 If the user wishes to display the entire color table associated with a
91 map, the user should either stipulate a number of lines (rows) and col‐
92 umns (cols) sufficient to accommodate the number of categories in the
93 map's color table, or fail to assign values to one or both of lines
94 and/or cols. If the user runs d.colortable using the default number of
95 lines and columns (the full graphics frame), all categories from the
96 map's color table will be displayed. However, if the user requests that
97 the color table associated with a map which has 10 data categories be
98 displayed in a graphics frame with only 3 lines (rows) and 2 columns (a
99 total of six cells), only six of the ten map categories will be dis‐
100 played.
101 The user should run the GRASS program d.erase between runs of d.col‐
103 ortable to avoid confusion.
104
106 d.colors
107 d.erase
108 d.rast
109 parser
110
112 James Westervelt, U.S. Army Construction Engineering Research Labora‐
113 tory
114 Last changed: $Date: 2007-04-11 15:45:53 +0200 (Wed, 11 Apr 2007) $
116 Full index
118 © 2003-2008 GRASS Development Team
120GRASS 6.3.0 d.colortable(1)