---
name: "d.rast"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/d.rast"
---

# d.rast(1grass)

Displays user-specified raster map in the active graphics frame.

## NAME

**d.rast**  - Displays user-specified raster map in the active graphics frame.

## KEYWORDS

display, graphics, raster

## SYNOPSIS

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

### Flags:

- **-n**

  Make null cells opaque

- **-i**

  Invert value list

- **--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 to be displayed

- **values**=*value\[-value\]\[,value\[-value\]*,...\]

  List of categories or values to be displayed

- **bgcolor**=*color*

  Background color (for null)\
   Either a standard color name or R:G:B triplet\
   Default: *white*

## DESCRIPTION

*d.rast* displays the specified raster map in the active display frame on the graphics monitor.

## EXAMPLE

Display raster map "elevation":\

```
d.rast map=elevation
```

*Figure: elevation raster map visualization* 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* 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*

## SEE ALSO

*d.rast.arrow,* *d.rast.num,* *d.rast.leg,* *d.legend,* *d.mon,* *d.erase,* *d.vect*

*wxGUI*

## AUTHOR

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

## SOURCE CODE

Available at: d.rast source code (history)

Accessed: Monday Feb 24 17:50:26 2025

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual