r.shade(1grass) GRASS GIS User's Manual r.shade(1grass)
NAME
r.shade - Drapes a color raster over an shaded relief or aspect map.
KEYWORDS
raster, elevation, relief, hillshade, visualization
SYNOPSIS
r.shade
r.shade --help
r.shade [-c] shade=name color=name output=name [brighten=integer]
[bgcolor=name] [--overwrite] [--help] [--verbose] [--quiet]
[--ui]
Flags:
-c
Use colors from color tables for NULL values
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog
Parameters:
shade=name [required]
Name of shaded relief or aspect raster map
color=name [required]
Name of raster to drape over relief raster map
Typically, this raster is elevation or other colorful raster
output=name [required]
Name of shaded raster map
brighten=integer
Percent to brighten
Options: -99-99
Default: 0
bgcolor=name
Color to use instead of NULL values
Either a standard color name, R:G:B triplet, or "none"
DESCRIPTION
r.shade will drape a color raster map over a shaded relief map. In
place of shaded relief, any raster map can be used including aspect or
slope. The color raster map is usually an elevation raster map with
colorful color table (as opposed to gray scale color table). However,
any raster map can be used including categorical raster maps. The re-
sult is a raster map created from elevation and the shade raster.
Comparing to creating shaded relief as semi-transparent overlay on the
color raster map, this module gives result with more saturated colors.
The input for this module can be created for example using r.slope.as-
pect or r.relief.
NULL values are propagated by default, so if any of the two input
rasters contains NULL cell NULL will be also in the output. If -c flag
is used and cell in color raster is NULL, just shade color is used. If
cell in shade raster is NULL, shading effect is not applied and origi-
nal colors are used. If bgcolor option is used, NULL value in any input
raster will be in the output replaced by the given color.
NOTES
Refer to the r.his help page for more details; r.shade is a frontend to
that module with addition of brightness support similar to one provided
by d.shade. However, note that the brightness is not implemenented in
the same way as for d.shade and the results might be different.
r.shade is using method described in r.his manual page.
EXAMPLES
In this example, the aspect map in the North Carolina sample dataset
location is used to hillshade the elevation map:
g.region raster=aspect -p
r.shade shade=aspect color=elevation output=elevation_aspect_shaded
d.mon wx0
d.rast elevation_aspect_shaded
In this next example, a shaded relief raster map is created and used to
create a colorized hillshade raster map for later use:
g.region raster=elevation
r.relief input=elevation output=elevation_shaded_relief
r.shade shade=elevation_shaded_relief color=elevation \
output=elevation_relief_shaded
d.mon wx1
d.rast elevation_relief_shaded
Interesting visualizations can be created using different color tables
for elevation raster map, for example using haxby color table.
Figure: A detail of raster created by applying shading effect of shaded
relief (hillshade) to elevation raster map from North Carolina dataset
elevation map
SEE ALSO
r.his, d.his, d.shade, g.pnmcomp, r.slope.aspect, r.relief
AUTHORS
Hamish Bowman
Vaclav Petras, NCSU OSGeoREL
Inspired by d.shade and manual for r.his.
SOURCE CODE
Available at: r.shade source code (history)
Accessed: unknown
Main index | Raster index | Topics index | Keywords index | Graphical
index | Full index
© 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual
GRASS 7.8.7 r.shade(1grass)
Generated by dwww version 1.14 on Sat Jun 13 12:42:09 CEST 2026.