---
name: "d.rast.leg"
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.leg"
---

# d.rast.leg(1grass)

Displays a raster map and its legend on a graphics window

## NAME

**d.rast.leg**  - Displays a raster map and its legend on a graphics window

## KEYWORDS

display, cartography, legend

## SYNOPSIS

**d.rast.leg**\
 **d.rast.leg --help**\
 **d.rast.leg** \[-**fns**\] **map**=*name*  \[**lines**=*integer*\]   \[**raster**=*name*\]   \[--**help**\]  \[--**verbose**\]  \[--**quiet**\]  \[--**ui**\]

### Flags:

- **-f**

  Flip legend

- **-n**

  Omit entries with missing label

- **-s**

  Draw smooth gradient

- **--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 display

- **lines**=*integer*

  Number of lines to appear in the legend

- **raster**=*name*

  Name of input raster map to generate legend from

## DESCRIPTION

*d.rast.leg* shows a raster map along with its legend. It first clears the entire screen, then divides it into a main (left) and a minor (right) frames, and displays a raster map in the main frame and the map legend in the minor frame. The main frame remains active when the program finishes.

## NOTES

The legend may be flipped with the **-f** flag.

If the **lines** parameter is not given then the legend frame will display as many lines as number of categories in the map, otherwise, it will display the first **lines** minus 1 categories with the rest being truncated.

The user may adjust the **lines** parameter or the size of graphics window to get an appropriate result.

The user may specify a second raster map with the **raster** parameter from which the legend is generated. This is useful to visualize (time) series of raster maps with a common static legend instead of the default dynamic legend.

To remove all frames when clearing the display, use `d.erase -f`.

## EXAMPLE

In this example, the polar diagram of the ’aspect’ angle map in the North Carolina sample dataset is generated:\

```
g.region raster=landclass96 -p
d.rast.leg landclass96
```

## SEE ALSO

*d.legend,* *d.erase,* *d.rast*

## AUTHORS

Jianping Xu, Scott Madry, Rutgers University\
 Markus Neteler

## SOURCE CODE

Available at: d.rast.leg source code (history)

Accessed: Monday Feb 24 17:51:43 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