d.colortable(1grass)

✨ NAME ✨

okay so bestie, d.colortable — say it with me, d dot colortable — is the lil icon that displays the color table associated with a raster map layer. that's it, that's the whole vibe. it's from the GRASS User's Manual and it's literally serving looks for your raster data 💅

🏷️ KEYWORDS 🏷️

display, raster, color table

---

📜 SYNOPSIS 📜

d.colortable
d.colortable --help
d.colortable [-n] map=name  [color=name]   [lines=integer]
[columns=integer]   [--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags 🚩

• -n — Do not draw a collar showing the NULL color in FP maps
• --help — Print usage summary
• --verbose — Verbose module output
• --quiet — Quiet module output
• --ui — Force launching GUI dialog

🎀 Parameters 🎀

• map=name [required] — Name of raster map whose color table is to be displayed
• color=name — Color of lines separating the colors of the color table Either a standard color name or R:G:B triplet Default: white
• lines=integer — Number of lines to appear in the color table Options: 1-1000
• columns=integer — Number of columns to appear in the color table Options: 1-1000

---

🌈 DESCRIPTION 🌈

so d.colortable is used to display the color table associated with a raster map in the active frame on the graphics monitor. the map name should be an available raster map in the user's current mapset search path and location. iykyk 🦋

if the values of both lines and columns are not specified by the user, d.colortable divides the active frame equally among the number of categories present in the named raster map. if one option is specified, the other is automatically set to accommodate all categories. and if both are specified, then as many categories as possible get displayed. it's giving "we'll figure it out" energy and honestly? it works 🔥

if the user specifies the name of a map on the command line but does not specify the values of other parameters, parameter default values will be used. alternately, if the user types simply d.colortable on the command line without any program arguments, the program will prompt the user for parameter settings using the standard GRASS parser interface. no cap.

---

🌸 EXAMPLE 🌸

the user running the command:

d.colortable map=soils color=red lines=1 columns=3

would see the active graphics frame divided into three columns extending the full frame height. the lines dividing the color table associated with the soils map would be displayed in red. the user would see, at most, only three of the colors from the soils color table displayed in the active frame (because the user requested that this frame be divided into three sections). three cells, three colors, main character behavior, periodt 💖

---

🧚 NOTES 🧚

if the user wishes to display the entire color table associated with a map, the user should either stipulate a number of lines (rows) and columns (cols) sufficient to accommodate the number of categories in the map's color table, or fail to assign values to one or both of lines and/or columns. if the user runs d.colortable using the default number of lines and columns (the full graphics frame), all categories from the map's color table will be displayed.

however, if the user requests that the color table associated with a map which has 10 data categories be displayed in a graphics frame with only 3 lines (rows) and 2 columns (a total of six cells), only six of the ten map categories will be displayed. 😭 the other four are just… not invited to the party. math is math.

⚠️ real talk bestie: the user should run d.erase between runs of d.colortable to avoid confusion. don't skip this one, the overlapping frames get messy and it's not cute 💀

---

👀 SEE ALSO 👀

d.erase, d.legend, d.rast

---

👑 AUTHOR 👑

James Westervelt, U.S. Army Construction Engineering Research Laboratory

---

💾 SOURCE CODE 💾

Available at: d.colortable source code (history)

Latest change: Friday Feb 07 19:16:09 2025 in commit: a82a39f673b97fafcfce1604dc3e6015cb96487a

Main index | Display index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

and that's the whole page, babe 🫶 this was d.colortable(1grass) from the GRASS 8.5.0 era — go forth and display those color tables, you absolute legend 🎀✨