1r.shade(1) Grass User's Manual r.shade(1)
2
6 r.shade - Drapes a color raster over an shaded relief or aspect map.
7
9 raster, elevation, relief, hillshade, visualization
10
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 Flags:
19 -c
20 Use colors from color tables for NULL values
21 --overwrite
23 Allow output files to overwrite existing files
24 --help
26 Print usage summary
27 --verbose
29 Verbose module output
30 --quiet
32 Quiet module output
33 --ui
35 Force launching GUI dialog
36 Parameters:
38 shade=name [required]
39 Name of shaded relief or aspect raster map
40 color=name [required]
42 Name of raster to drape over relief raster map
43 Typically, this raster is elevation or other colorful raster
44 output=name [required]
46 Name of shaded raster map
47 brighten=integer
49 Percent to brighten
50 Options: -99-99
51 Default: 0
52 bgcolor=name
54 Color to use instead of NULL values
55 Either a standard color name, R:G:B triplet, or "none"
56
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
63 result is a raster map created from elevation and the shade raster.
64 Comparing to creating shaded relief as semi-transparent overlay on the
66 color raster map, this module gives result with more saturated colors.
67 The input for this module can be created for example using
69 r.slope.aspect or r.relief.
70 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
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
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 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
108 r.his, d.his, d.shade, g.pnmcomp, r.slope.aspect, r.relief
109
111 Hamish Bowman
112 Vaclav Petras, NCSU OSGeoREL
113 Inspired by d.shade and manual for r.his.
114 Last changed: $Date: 2015-09-02 13:01:34 +0200 (Wed, 02 Sep 2015) $
116
118 Available at: r.shade source code (history)
119 Main index | Raster index | Topics index | Keywords index | Graphical
121 index | Full index
122 © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
124GRASS 7.4.4 r.shade(1)