d.rast.leg - GRASS GIS manual
Author: GRASS Development Team
Description: d.rast.leg: Displays a raster map and its legend on a graphics window
Keywords: display, cartography, legend

## 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: Saturday May 09 11:20:48 2026

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

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