|
@@ -1,41 +1,30 @@
|
|
|
-<H2>DESCRIPTION</H2>
|
|
|
+<h2>DESCRIPTION</h2>
|
|
|
|
|
|
-
|
|
|
-<EM>r.shaded.relief</EM> is a Bourne shell script that
|
|
|
-creates a raster shaded relief map based on current
|
|
|
+<em>r.shaded.relief</em> creates a raster shaded relief map based on current
|
|
|
resolution settings and on sun altitude, azimuth, and z-exaggeration values
|
|
|
entered by the user. If no output shademap name is given, the new shaded
|
|
|
-relief map is named <EM><input_map>.shade</EM>.
|
|
|
+relief map is named <em><input_map>.shade</em>.
|
|
|
The map is assigned a grey-scale color table.
|
|
|
|
|
|
-
|
|
|
-<P>
|
|
|
-If no parameters are provided on startup, this program is interactive;
|
|
|
-thus if the user enters the command:
|
|
|
-
|
|
|
-<DL>
|
|
|
-<DD>
|
|
|
-<B>r.shaded.relief</B>
|
|
|
-</DL>
|
|
|
-
|
|
|
-The program then prompts the user to enter values for:
|
|
|
-<OL>
|
|
|
-<LI>The <B>altitude</B> of the sun in degrees above the horizon
|
|
|
+<p>
|
|
|
+The module then prompts the user to enter values for:
|
|
|
+<ol>
|
|
|
+<li>The <b>altitude</b> of the sun in degrees above the horizon
|
|
|
(a value between 0 and 90 degrees), and
|
|
|
|
|
|
-<LI>The <B>azimuth</B> of the sun in degrees to the east of north
|
|
|
+<li>The <b>azimuth</b> of the sun in degrees to the east of north
|
|
|
(a value between 0 and 360 degrees).
|
|
|
|
|
|
-<LI>The name of a raster map layer to provide elevation values for the
|
|
|
+<li>The name of a raster map layer to provide elevation values for the
|
|
|
shaded relief map. Typically, this would be a map layer of elevation;
|
|
|
however, any raster map layer can be named.
|
|
|
|
|
|
-<LI>The scaling parameter, which compensates for a different horizontal
|
|
|
-<B>scale</B> than vertical scale. If 'scale' is a number then the ewres
|
|
|
+<li>The scaling parameter, which compensates for a different horizontal
|
|
|
+<b>scale</b> than vertical scale. If 'scale' is a number then the ewres
|
|
|
and nsres are multiplied by that scale to calculate the shading. (Default=1.0
|
|
|
for equivalent horizontal and vertical scales.)
|
|
|
|
|
|
-<LI>For the special case when a latitude-longitude projection is used with an
|
|
|
+<li>For the special case when a latitude-longitude projection is used with an
|
|
|
elevation map measured in meters (e.g., SRTM, ETOPO2 etc.) or feet, the
|
|
|
<b>units</b> can be set to automatically set the horizontal scale to the the number of
|
|
|
meters (scale=111120) or feet (scale=370400) in a degree of latitude. The script scales
|
|
@@ -43,37 +32,47 @@ latitude and longitude equally, so it's only approximately right, but for shadin
|
|
|
it's close enough. It makes the difference between a usable and unusable shade.
|
|
|
The <b>units</b> parameter overrides the <b>scale</b> parameter.
|
|
|
|
|
|
-<LI>The <b>zmult</b> exaggeration factor that changes the apparent relief
|
|
|
+<li>The <b>zmult</b> exaggeration factor that changes the apparent relief
|
|
|
for the shaded relief map. This can be any positive (or negative) floating
|
|
|
point value. (Default=1.0)
|
|
|
+</ol>
|
|
|
|
|
|
-</OL>
|
|
|
-
|
|
|
-Specifically, <EM>r.shaded.relief</EM> executes a
|
|
|
-<EM><A HREF="r.mapcalc.html">r.mapcalc</A></EM>
|
|
|
-statement. Refer to the manual entry for
|
|
|
-<EM><A HREF="r.mapcalc.html">r.mapcalc</A></EM> for an explanation
|
|
|
+Specifically, <em>r.shaded.relief</em> executes a <em>r.mapcalc</em>
|
|
|
+statement. Refer to the manual entry for <em>r.mapcalc</em> for an explanation
|
|
|
of the filtering syntax shown in the above expression.
|
|
|
See, for example, the section on "The Neighborhood Modifier".
|
|
|
|
|
|
-<P>
|
|
|
-<EM>r.shaded.relief</EM> then runs <EM><a href="r.colors.html">r.colors</A></EM>
|
|
|
+<p>
|
|
|
+<em>r.shaded.relief</em> then runs <em>r.colors</em>
|
|
|
to assign a grey-scale color table to the new shaded relief map.
|
|
|
|
|
|
-<H2>NOTES</H2>
|
|
|
+<h2>NOTES</h2>
|
|
|
|
|
|
To visually improve the result of shade maps from low resolution elevation
|
|
|
models, use <em>r.resamp.interp</em> with bilinear or bicubic method to
|
|
|
-resample the DEM at higher resolution. <EM>r.shaded.relief</EM> is then
|
|
|
+resample the DEM at higher resolution. <em>r.shaded.relief</em> is then
|
|
|
run on the resampled DEM.
|
|
|
|
|
|
-<H2>FILES</H2>
|
|
|
+<h2>EXAMPLES</h2>
|
|
|
+
|
|
|
+In this example, the aspect map in the North Carolina sample
|
|
|
+dataset location is used to hillshade the elevation map:
|
|
|
+
|
|
|
+<div class="code"><pre>
|
|
|
+g.region rast=elevation -p
|
|
|
+r.shaded.relief input=elevation output=elevation.shaded
|
|
|
+</pre></div>
|
|
|
+
|
|
|
+<p>
|
|
|
+In Latitude-Longitude locations (or other non-metric locations), the
|
|
|
+<em>scale</em> factor has to be used:
|
|
|
|
|
|
-This program is simply a shell script. Users are encouraged to make their
|
|
|
-own shell scripts using similar techniques.
|
|
|
-See <KBD>$GISBASE/scripts/r.shaded.relief</KBD>.
|
|
|
+<div class="code"><pre>
|
|
|
+# Latitude-Longitude example
|
|
|
+r.shaded.relief input=srtm output=srtm.shaded scale=111120
|
|
|
+</pre></div>
|
|
|
|
|
|
-<H2>SEE ALSO</H2>
|
|
|
+<h2>SEE ALSO</h2>
|
|
|
|
|
|
"<i>r.mapcalc: An Algebra for GIS and Image Processing</i>", by Michael Shapiro
|
|
|
and Jim Westervelt, U.S. Army Construction Engineering Research Laboratory
|
|
@@ -83,16 +82,16 @@ and Jim Westervelt, U.S. Army Construction Engineering Research Laboratory
|
|
|
<!-- RGB version not ported to GRASS 6:
|
|
|
<EM><A HREF="shade.clr.sh.html">shade.clr.sh</A></EM><BR>
|
|
|
-->
|
|
|
-<EM>
|
|
|
-<A HREF="d.his.html">d.his</A>,<br>
|
|
|
-<A HREF="g.region.html">g.region</A>,<br>
|
|
|
-<A HREF="r.blend.html">r.blend</A>,<br>
|
|
|
-<A HREF="r.colors.html">r.colors</A>,<br>
|
|
|
-<A HREF="r.mapcalc.html">r.mapcalc</A>,<br>
|
|
|
-<A HREF="r.resamp.interp.html">r.resamp.interp</A>
|
|
|
-</EM>
|
|
|
-
|
|
|
-<H2>AUTHOR</H2>
|
|
|
+<em>
|
|
|
+<a href="d.his.html">d.his</a>,
|
|
|
+<a href="g.region.html">g.region</a>,
|
|
|
+<a href="r.blend.html">r.blend</a>,
|
|
|
+<a href="r.colors.html">r.colors</a>,
|
|
|
+<a href="r.mapcalc.html">r.mapcalc</a>,
|
|
|
+<a href="r.resamp.interp.html">r.resamp.interp</a>
|
|
|
+</em>
|
|
|
+
|
|
|
+<h2>AUTHOR</h2>
|
|
|
|
|
|
Jim Westervelt, U.S. Army Construction Engineering
|
|
|
Research Laboratory
|