1r.shade(1)                  GRASS GIS User's Manual                 r.shade(1)
2
3
4

NAME

6       r.shade  - Drapes a color raster over an shaded relief or aspect map.
7

KEYWORDS

9       raster, elevation, relief, hillshade, visualization
10

SYNOPSIS

12       r.shade
13       r.shade --help
14       r.shade  [-c]  shade=name  color=name  output=name   [brighten=integer]
15       [bgcolor=name]    [--overwrite]    [--help]    [--verbose]    [--quiet]
16       [--ui]
17
18   Flags:
19       -c
20           Use colors from color tables for NULL values
21
22       --overwrite
23           Allow output files to overwrite existing files
24
25       --help
26           Print usage summary
27
28       --verbose
29           Verbose module output
30
31       --quiet
32           Quiet module output
33
34       --ui
35           Force launching GUI dialog
36
37   Parameters:
38       shade=name [required]
39           Name of shaded relief or aspect raster map
40
41       color=name [required]
42           Name of raster to drape over relief raster map
43           Typically, this raster is elevation or other colorful raster
44
45       output=name [required]
46           Name of shaded raster map
47
48       brighten=integer
49           Percent to brighten
50           Options: -99-99
51           Default: 0
52
53       bgcolor=name
54           Color to use instead of NULL values
55           Either a standard color name, R:G:B triplet, or "none"
56

DESCRIPTION

58       r.shade  will  drape  a  color raster map over a shaded relief map.  In
59       place of shaded relief, any raster map can be used including aspect  or
60       slope.   The  color  raster map is usually an elevation raster map with
61       colorful color table (as opposed to gray scale color  table).  However,
62       any  raster map can be used including categorical raster maps.  The re‐
63       sult is a raster map created from elevation and the shade raster.
64
65       Comparing to creating shaded relief as semi-transparent overlay on  the
66       color raster map, this module gives result with more saturated colors.
67
68       The  input for this module can be created for example using r.slope.as‐
69       pect or r.relief.
70
71       NULL values are propagated by default, so  if  any  of  the  two  input
72       rasters  contains NULL cell NULL will be also in the output. If -c flag
73       is used and cell in color raster is NULL, just shade color is used.  If
74       cell  in shade raster is NULL, shading effect is not applied and origi‐
75       nal colors are used. If bgcolor option is used, NULL value in any input
76       raster will be in the output replaced by the given color.
77

NOTES

79       Refer to the r.his help page for more details; r.shade is a frontend to
80       that module with addition of brightness support similar to one provided
81       by  d.shade.  However, note that the brightness is not implemenented in
82       the same way as  for  d.shade  and  the  results  might  be  different.
83       r.shade is using method described in r.his manual page.
84

EXAMPLES

86       In  this  example,  the aspect map in the North Carolina sample dataset
87       location is used to hillshade the elevation map:
88       g.region raster=aspect -p
89       r.shade shade=aspect color=elevation output=elevation_aspect_shaded
90       d.mon wx0
91       d.rast elevation_aspect_shaded
92       In this next example, a shaded relief raster map is created and used to
93       create a colorized hillshade raster map for later use:
94       g.region raster=elevation
95       r.relief input=elevation output=elevation_shaded_relief
96       r.shade shade=elevation_shaded_relief color=elevation \
97           output=elevation_relief_shaded
98       d.mon wx1
99       d.rast elevation_relief_shaded
100       Interesting  visualizations can be created using different color tables
101       for elevation raster map, for example using haxby color table.
102
103       Figure: A detail of raster created by applying shading effect of shaded
104       relief  (hillshade) to elevation raster map from North Carolina dataset
105       elevation map
106

SEE ALSO

108        r.his, d.his, d.shade, g.pnmcomp, r.slope.aspect, r.relief
109

AUTHORS

111       Hamish Bowman
112       Vaclav Petras, NCSU OSGeoREL
113       Inspired by d.shade and manual for r.his.
114

SOURCE CODE

116       Available at: r.shade source code (history)
117
118       Accessed: Saturday Jan 21 21:17:02 2023
119
120       Main index | Raster index | Topics index | Keywords index  |  Graphical
121       index | Full index
122
123       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
124
125
126
127GRASS 8.2.1                                                         r.shade(1)
Impressum