d.rast.leg.1grass man page

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


display, cartography, legend


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


Flip legend
Omit entries with missing label
Draw smooth gradient
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


map=name [required]
Name of raster map to display
Number of lines to appear in the legend
Name of input raster map to generate legend from


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.


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.


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

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

See Also

d.legend, d.erase, d.rast


Jianping Xu, Scott Madry, Rutgers University
Markus Neteler

Last changed: $Date: 2014-11-28 17:25:40 +0100 (Fri, 28 Nov 2014) $

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

© 2003-2016 GRASS Development Team, GRASS GIS 7.0.4 Reference Manual


GRASS 7.0.4 Grass User's Manual