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