[GRASS-SVN] r62848 - in grass/branches/releasebranch_7_0: . raster/r.thin

Fri Nov 21 07:48:14 PST 2014

Author: neteler
Date: 2014-11-21 07:48:14 -0800 (Fri, 21 Nov 2014)
New Revision: 62848

Added:
   grass/branches/releasebranch_7_0/raster/r.thin/r_thin_network.png
   grass/branches/releasebranch_7_0/raster/r.thin/r_thin_vectorized.png
Modified:
   grass/branches/releasebranch_7_0/
   grass/branches/releasebranch_7_0/raster/r.thin/
   grass/branches/releasebranch_7_0/raster/r.thin/r.thin.html
Log:
r.thin manual: example added


Property changes on: grass/branches/releasebranch_7_0
___________________________________________________________________
Modified: svn:mergeinfo
   - /grass/trunk:60817,61096,61141,62179-62180,62182,62403,62422,62424,62437,62466,62469,62487,62491,62494,62501,62506,62508-62509,62515,62518-62519,62521,62526,62533,62539,62541,62555,62562,62566,62570,62573,62575,62585,62588,62597,62603,62606,62608-62609,62614,62618,62628,62632,62638,62642,62648-62649,62652,62654-62657,62666,62691,62705,62709,62723,62730,62739,62741,62743,62746,62750,62752,62757,62762,62785,62798,62800-62801,62803,62805,62812,62822,62824,62831,62838
   + /grass/trunk:60817,61096,61141,62179-62180,62182,62403,62422,62424,62437,62466,62469,62487,62491,62494,62501,62506,62508-62509,62515,62518-62519,62521,62526,62533,62539,62541,62555,62562,62566,62570,62573,62575,62585,62588,62597,62603,62606,62608-62609,62614,62618,62628,62632,62638,62642,62648-62649,62652,62654-62657,62666,62691,62705,62709,62723,62730,62739,62741,62743,62746,62750,62752,62757,62762,62785,62798,62800-62801,62803,62805,62812,62822,62824,62831,62838,62847


Property changes on: grass/branches/releasebranch_7_0/raster/r.thin
___________________________________________________________________
Modified: svn:ignore
   - OBJ.*

   + OBJ.*
*.tmp.html


Modified: grass/branches/releasebranch_7_0/raster/r.thin/r.thin.html
===================================================================

--- grass/branches/releasebranch_7_0/raster/r.thin/r.thin.html	2014-11-21 15:47:40 UTC (rev 62847)
+++ grass/branches/releasebranch_7_0/raster/r.thin/r.thin.html	2014-11-21 15:48:14 UTC (rev 62848)
@@ -1,8 +1,10 @@
 <h2>DESCRIPTION</h2>
 
-<em>r.thin</em> scans the named <em>input</em> raster map
-layer and thins non-zero cells that denote linear features
-into linear features having a single cell width.
+<em>r.thin</em> scans the named <em>input</em> raster map layer and 
+thins non-zero cells that denote linear features into linear features 
+having a single cell width. Raster lines often need to be thinned 
+(skeletonizing raster features) to a single pixel width before they can 
+be transformed to vector data.
 
 <p>
 <em>r.thin</em> will thin only the non-zero cells of the
@@ -18,25 +20,24 @@
 data file containing the thinned linear features.
 <em>r.thin</em> assumes that linear features are encoded
 with positive values on a background of 0's in the
-<em>input</em> raster data file.
+<em>input</em> raster data file, hence it creates a 0/1
+output map.
 
-<h2>NOTE</h2>
+<h2>NOTES</h2>
 
-<em>r.thin</em> only creates raster map layers.  The user will need to run 
+<em>r.thin</em> only creates raster map layers. In order to
+create a vector map, the user will need to run 
 <em><a href="r.to.vect.html">r.to.vect</a></em>
-on the resultant raster map to create a vector 
-(<em><a href="wxGUI.vdigit.html">wxGUI vector digitizer</a></em>) map layer.
+on the resultant raster map.
 
-<p><em>r.thin</em> may create small spurs or "dangling lines"
+<p>
+<em>r.thin</em> may create small spurs or "dangling lines"
 during the thinning process.  These spurs may be removed
 (after creating a vector map layer) by
-<em><a href="v.clean.html">v.clean</a></em>.
+<em><a href="v.clean.html">v.clean</a></em> (<em>rmdangle</em>
+tool).
 
 <p>
-<em>r.thin</em> creates a 0/1 output map.
-
-<h2>NOTE</h2>
-
 This code implements the thinning algorithm described in
 "Analysis of Thinning Algorithms Using Mathematical
 Morphology" by Ben-Kwei Jang and Ronlad T. Chin in
@@ -47,7 +48,8 @@
 object while retaining any pixels whose removal would alter
 the connectivity or shorten the legs of the sceleton."
 
-<p>The sceleton is finally thinned when the thinning process
+<p>
+The sceleton is finally thinned when the thinning process
 converges; i.e., "no further pixels can be removed without
 altering the connectivity or shortening the sceleton legs"
 (p. 541).  The authors prove that the thinning process
@@ -58,6 +60,56 @@
 object is <= n pixels thick, the algorithm should
 converge in <= iterations.
 
+<h2>EXAMPLE</h2>
+
+To vectorize the raster map <em>streams_derived</em> in the North 
+Carolina sample dataset that represents the stream network derived from 
+the 10m resolution DEM by <em>r.watershed</em>, run:
+
+<div class="code"><pre>
+g.region rast=elevation -p
+# create flow accumulation map
+r.watershed elevation=elevation accumulation=accum_50K thresh=50000
+# extract streams from flow accumulation map
+r.mapcalc "streams_from_flow = if(abs(accum_50K) > 1000, 1, null())"
+
+# skeletonize map
+r.thin streams_from_flow out=streams_thin
+
+d.mon wx0
+d.rast streams_from_flow
+d.erase
+d.rast streams_thin
+</pre></div>
+<p>
+
+<center>
+<img src="r_thin_network.png" alt="Raster feature thinning (skeletonizing)"><br>
+Raster feature thinning (skeletonizing)
+</center>
+<p>
+
+The resulting map cabe optionally vectorized:
+<div class="code"><pre>
+r.to.vect streams_thin output=streams_thin type=line
+# visualize
+d.rast accum_50K
+d.vect streams_thin color=red width=2
+</pre></div>
+<p>
+
+<center>
+<img src="r_thin_vectorized.png" alt="Vectorized stream network after thinning extracted from flow accumulation map"><br>
+Vectorized stream network after thinning extracted from flow accumulation map
+</center>
+
+<!--
+# compare to official NC stream map
+d.erase
+d.vect streams_thin color=red width=2
+d.vect streams color=blue width=2
+-->
+
 <h2>SEE ALSO</h2>
 
 <em>

Copied: grass/branches/releasebranch_7_0/raster/r.thin/r_thin_network.png (from rev 62847, grass/trunk/raster/r.thin/r_thin_network.png)
===================================================================
(Binary files differ)

Copied: grass/branches/releasebranch_7_0/raster/r.thin/r_thin_vectorized.png (from rev 62847, grass/trunk/raster/r.thin/r_thin_vectorized.png)
===================================================================
(Binary files differ)

