[GRASS-SVN] r58493 - grass-addons/grass7/raster/r.local.relief
svn_grass at osgeo.org
svn_grass at osgeo.org
Thu Dec 19 14:46:26 PST 2013
Author: wenzeslaus
Date: 2013-12-19 14:46:26 -0800 (Thu, 19 Dec 2013)
New Revision: 58493
Added:
grass-addons/grass7/raster/r.local.relief/r.local.relief.png
grass-addons/grass7/raster/r.local.relief/r.local.relief_redblue.png
Modified:
grass-addons/grass7/raster/r.local.relief/r.local.relief.html
Log:
r.local.relief: improving manual, adding example and images
Modified: grass-addons/grass7/raster/r.local.relief/r.local.relief.html
===================================================================
--- grass-addons/grass7/raster/r.local.relief/r.local.relief.html 2013-12-19 15:17:16 UTC (rev 58492)
+++ grass-addons/grass7/raster/r.local.relief/r.local.relief.html 2013-12-19 22:46:26 UTC (rev 58493)
@@ -13,16 +13,25 @@
<li>Subtract the purged DEM from the original DEM to get the local relief model.</li>
</ol>
<p>
-The interpolation step is performed by the <a href="r.fillnulls.html">r.fillnulls</a> module by default (using cubic interpolation).
-If this is not working on your data, you can use <em>-v</em> flag to use <a href="v.surf.bspline.html">v.surf.bspline</a> cubic interpolation instead (this might be slower on some types of data).
+The interpolation step is performed by the <em><a href="r.fillnulls.html">r.fillnulls</a></em> module by default (using cubic interpolation).
+If this is not working on your data, you can use <em>-v</em> flag to use <em><a href="v.surf.bspline.html">v.surf.bspline</a></em> cubic interpolation instead (this might be slower on some types of data).
</p>
<h2>OUTPUT</h2>
<p>
The final local relief model is named according to the <em>output</em> parameter.
-When the <em>-i</em> flag is specified, <em>r.local.relief</em> creates additional output files representing the intermediate steps in the LRM generation process. The names and number of the intermediate files vary depending on whether <a href="r.fillnulls.html">r.fillnulls</a> (default) or <a href="v.surf.bspline.html">v.surf.bspline</a> (specified by using the <em>-v</em> flag) is used for interpolation. The intermediate maps are composed of the user-specified <em>output</em> parameter and suffixes describing the intermediate map.</p>
+When the <em>-i</em> flag is specified, <em>r.local.relief</em> creates additional
+output files representing the intermediate steps in the LRM generation process.
+The names and number of the intermediate files vary depending
+on whether <em><a href="r.fillnulls.html">r.fillnulls</a></em> (default)
+or <em><a href="v.surf.bspline.html">v.surf.bspline</a></em>
+(specified by using the <em>-v</em> flag) is used for interpolation.
+The intermediate maps are composed of the user-specified <em>output</em>
+parameter and suffixes describing the intermediate map.</p>
-<p>Without using the <em>-v</em> flag (<a href="r.fillnulls.html">r.fillnulls</a> interpolation), intermediate maps have the following suffixes:</p>
+<p>Without using the <em>-v</em> flag
+(<em><a href="r.fillnulls.html">r.fillnulls</a></em> interpolation),
+intermediate maps have the following suffixes:</p>
<ul>
<li><tt>_smooth_elevation</tt>: The result of running the low pass filter on the DEM.</li>
<li><tt>_subtracted_smooth_elevation</tt>: The result of subtracting the low pass filter map from the DEM.</li>
@@ -30,7 +39,9 @@
<li><tt>_purged_elevation</tt>: The raster interpolated from the _raster_contours_with_values map based that represents the large-scale landforms.</li>
</ul>
-<p>With using the <em>-v</em> flag (<a href="v.surf.bspline.html">v.surf.bspline</a> interpolation), intermediate maps have the following suffixes:</p>
+<p>With using the <em>-v</em> flag
+(<em><a href="v.surf.bspline.html">v.surf.bspline</a></em> interpolation),
+intermediate maps have the following suffixes:</p>
<ul>
<li><tt>_smooth_elevation</tt>: The result of running the low pass filter on the DEM.</li>
<li><tt>_subtracted_smooth_elevation</tt>: The result of subtracting the low pass filter map from the DEM.</li>
@@ -39,6 +50,11 @@
<li><tt>_purged_elevation</tt>: The raster interpolated from the _contour_points map that represents the large-scale landforms.</li>
</ul>
+<p>
+The module sets equalized gray scale color table for local relief model map
+and for the elevation difference (subtracted elevations). The color tables
+of other raster maps are set to the same color table as the input elevation map has.
+
<h2>EXAMPLE</h2>
Basic example using the default neighborhood size of 11:
@@ -51,25 +67,71 @@
</pre></div>
Example using the default neighborhood size of 11 and saving the intermediate maps:
<div class="code"><pre>
-r.local.relief -i input=elevation output=lrm11
+r.local.relief -i input=elevation output=lrm11
</pre></div>
Example using the default neighborhood size of 11 with bspline interpolation and saving the intermediate maps:
<div class="code"><pre>
-r.local.relief -i -v input=elevation output=lrm11
+r.local.relief -i -v input=elevation output=lrm11
</pre></div>
+Example in NC sample location (area of Raleigh downtown):
+<div class="code"><pre>
+# set the computational region to area of interest
+g.region n=228010 s=223380 w=637980 e=644920 res=10
+# compute local relief model
+r.local.relief input=elevation output=elevation_lrm
+
+# show the maps, e.g. using monitors
+d.mon wx0
+d.rast elevation
+d.rast elevation_lrm
+
+# try alternative red (negative values) and blue (positive values) color table
+# color table shows only the high values which hides small streets
+# for non-unix operating systems use file or interactive input in GUI
+# instead of rules=- and EOF syntax
+r.colors map=elevation_lrm at PERMANENT rules=- <<EOF
+100% 0:0:255
+0 255:255:255
+0% 255:0:0
+nv 255:255:255
+default 255:255:255
+EOF
+</pre></div>
+
+<!--
+images generated using the example above
+saved from map display
+resized to 500x500 with keep ratio in Nautilus
+-->
+<center>
+<img src="r.local.relief.png" alt="Local relief in NC location (gray scale)">
+<img src="r.local.relief_redblue.png" alt="Local relief in NC location (red blue)">
+<p>
+Figure: Local relief model of downtown Raleigh area created from elevation raster
+map in NC sample location with the default (gray scale) color table
+and custom red (negative values) and blue (positive values) color table
+</center>
+
+
<h2>SEE ALSO</h2>
<em>
<a href="r.shaded.relief.html">r.shaded.relief</a>,
-<a href="r.shaded.pca.html">r.shaded.pca</a> (in GRASS Addons)
+<a href="http://grass.osgeo.org/grass70/manuals/addons/r.shaded.pca.html">r.shaded.pca</a> (in GRASS Addons)
</em>
<h2>REFERENCES</h2>
<ul>
- <li>Hesse, Ralf (2010). LiDAR-derived Local Relief Models - a new tool for archaeological prospection. <em>Archaeological Prospection</em> 17:67-72.</li>
- <li>Bennett, Rebecca (2011). <em>Archaeological Remote Sensing: Visualization and Analysis of grass-dominated environments using laser scanning and digital spectra data.</em> Unpublished PhD Thesis. Electronic Document, <a href="http://eprints.bournemouth.ac.uk/20459/1/Bennett%2C_Rebecca_PhD_Thesis_2011.pdf">http://eprints.bournemouth.ac.uk/20459/1/Bennett%2C_Rebecca_PhD_Thesis_2011.pdf</a>, Accessed 25 February 2013. (provided bash script with <a href="v.surf.bspline.html">v.surf.bspline</a>-based implementation)</li>
+ <li>Hesse, Ralf (2010).
+ LiDAR-derived Local Relief Models - a new tool for archaeological prospection.
+ <em>Archaeological Prospection</em> 17:67-72.</li>
+ <li>Bennett, Rebecca (2011).
+ <em>Archaeological Remote Sensing: Visualization and Analysis of grass-dominated environments using laser scanning and digital spectra data.</em> Unpublished PhD Thesis. Electronic Document,
+ <a href="http://eprints.bournemouth.ac.uk/20459/1/Bennett%2C_Rebecca_PhD_Thesis_2011.pdf">http://eprints.bournemouth.ac.uk/20459/1/Bennett%2C_Rebecca_PhD_Thesis_2011.pdf</a>,
+ Accessed 25 February 2013.
+ (provided bash script with <em><a href="v.surf.bspline.html">v.surf.bspline</a></em>-based implementation)</li>
</ul>
<h2>AUTHOR</h2>
Added: grass-addons/grass7/raster/r.local.relief/r.local.relief.png
===================================================================
(Binary files differ)
Property changes on: grass-addons/grass7/raster/r.local.relief/r.local.relief.png
___________________________________________________________________
Added: svn:mime-type
+ image/png
Added: grass-addons/grass7/raster/r.local.relief/r.local.relief_redblue.png
===================================================================
(Binary files differ)
Property changes on: grass-addons/grass7/raster/r.local.relief/r.local.relief_redblue.png
___________________________________________________________________
Added: svn:mime-type
+ image/png
More information about the grass-commit
mailing list