1d.colortable(1) GRASS GIS User's Manual d.colortable(1)
2
6 d.colortable - Displays the color table associated with a raster map
7 layer.
8
10 display, raster, color table
11
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 Flags:
19 -n
20 Do not draw a collar showing the NULL color in FP maps
21 --help
23 Print usage summary
24 --verbose
26 Verbose module output
27 --quiet
29 Quiet module output
30 --ui
32 Force launching GUI dialog
33 Parameters:
35 map=name [required]
36 Name of raster map whose color table is to be displayed
37 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 lines=integer
44 Number of lines to appear in the color table
45 Options: 1-1000
46 columns=integer
48 Number of columns to appear in the color table
49 Options: 1-1000
50
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 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 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
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 di‐
78 vided into three sections).
79
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 The user should run d.erase between runs of d.colortable to avoid con‐
94 fusion.
95
97 d.erase, d.legend, d.rast
98
100 James Westervelt, U.S. Army Construction Engineering Research Labora‐
101 tory
102
104 Available at: d.colortable source code (history)
105 Accessed: Mon Jun 20 16:45:43 2022
107 Main index | Display index | Topics index | Keywords index | Graphical
109 index | Full index
110 © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
112GRASS 8.2.0 d.colortable(1)