d.rast(1grass)

🌸 NAME 🌸

okay so bestie, meet d.rast — she displays a user-specified raster map in the active graphics frame. that's it, that's the whole job, and she does it flawlessly 💅

this page lives in the GRASS User's Manual, section 1grass, and the keyword vibe check is: display, graphics, raster. iykyk 🦋

---

✨ SYNOPSIS ✨

d.rast
d.rast --help
d.rast [-ni] map=name  [values=value[-value][,value[-value],...]]
[bgcolor=color]   [--help]  [--verbose]  [--quiet]  [--ui]

🎀 Flags

• -n — makes null cells opaque. no vibe transparency, they're showing up.
• -i — invert the value list. flip it, reverse it, periodt.
• --help — prints the usage summary, aka the lil recap when you're lost 😭
• --verbose — verbose module output. she'll tell you everything, no gatekeeping.
• --quiet — quiet module output. shhh mode 🤫
• --ui — force launching the GUI dialog. main character pop-up energy ✨

🫶 Parameters

• map=name [required] — name of the raster map to be displayed. yes bestie, this one's required, she is NOT optional.
• values=value[-value][,value[-value],...] — list of categories or values to be displayed. pick your faves ✨
• bgcolor=color — background color (for null). either a standard color name or an R:G:B triplet. Default: white. 🤍

---

💖 DESCRIPTION 💖

so like, d.rast displays the specified raster map in the active display frame on the graphics monitor. that's the tea. she shows up, she serves the map, she leaves. iconic behavior honestly 👑

---

🌈 EXAMPLE 🌈

bestie let's display raster map "elevation":

d.rast map=elevation

Figure: elevation raster map visualization

now display raster map "elevation" but only the raster cells with values between 75 and 80 meters:

d.rast map=elevation values=75-80

Figure: elevation raster map showing values between 75 and 80 meters

and display raster map "landuse96_28m" but only categories 1 and 2:

d.rast landuse96_28m values=1,2

Figure: landuse raster map showing categories 1 and 2

not her doing all three flawlessly, no cap 🧚

---

👀 SEE ALSO 👀

• d.rast.arrow
• d.rast.num
• d.rast.leg
• d.legend
• d.mon
• d.erase
• d.vect

wxGUI

the whole friend group fr fr 🫶

---

💜 AUTHOR 💜

James Westervelt, U.S. Army Construction Engineering Research Laboratory. king behavior, we stan 🎀

---

⭐ SOURCE CODE ⭐

Available at: d.rast source code (history)

Latest change: Wednesday Feb 12 23:02:46 2025 in commit: 9c1146064f7c3c21fb0746063fa8bd2cdf4633cb

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 bestie, tysm for reading 💖

okay so final sign-off: this was GRASS 8.5.0, manual page d.rast from 1grass, dated Wednesday Feb 12 23:02:46 2025, landing in commit 9c1146064f7c3c21fb0746063fa8bd2cdf4633cb. slay, ate, no crumbs left 🌸✨👑