/usr/share/doc/grass-doc/html/r.thin.html is in grass-doc 6.4.3-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS manual: r.thin</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>r.thin</b></em> - Thins non-zero cells that denote linear features in a raster map.
<h2>KEYWORDS</h2>
raster, thin
<h2>SYNOPSIS</h2>
<b>r.thin</b><br>
<b>r.thin help</b><br>
<b>r.thin</b> <b>input</b>=<em>name</em> <b>output</b>=<em>name</em> [<b>iterations</b>=<em>integer</em>] [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>--overwrite</b></DT>
<DD>Allow output files to overwrite existing files</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>input</b>=<em>name</em></DT>
<DD>Name of input raster map</DD>
<DT><b>output</b>=<em>name</em></DT>
<DD>Name for output raster map</DD>
<DT><b>iterations</b>=<em>integer</em></DT>
<DD>Maximal number of iterations</DD>
<DD>Default: <em>200</em></DD>
</DL>
<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.
<p>
<em>r.thin</em> will thin only the non-zero cells of the
named <em>input</em> raster map layer within the current
geographic region settings. The cell width of the thinned
<em>output</em> raster map layer will be equal to the cell
resolution of the currently set geographic region. All of
the thinned linear features will have the width of a single
cell.
<p>
<em>r.thin</em> will create a new <em>output</em> raster
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.
<h2>NOTE</h2>
<em>r.thin</em> only creates raster map layers. You 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="v.digit.html">v.digit</a></em>) map layer.
<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>.
<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
<em>Transactions on Pattern Analysis and Machine
Intelligence</em>, vol. 12, No. 6, June 1990. The
definition Jang and Chin give of the thinning process is
"successive removal of outer layers of pixels from an
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
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
described always converges and produces one-pixel thick
sceletons. The number of iterations depends on the
original thickness of the object. Each iteration peels off
the outside pixels from the object. Therefore, if the
object is <= n pixels thick, the algorithm should
converge in <= iterations.
<h2>SEE ALSO</h2>
<em><a href="g.region.html">g.region</a></em>,
<em><a href="r.to.vect.html">r.to.vect</a></em>,
<em><a href="v.clean.html">v.clean</a></em>,
<em><a href="v.digit.html">v.digit</a></em>,
<em><a href="v.build.html">v.build</a></em>
<h2>AUTHOR</h2>
Olga Waupotitsch, U.S.Army Construction Engineering Research Laboratory
<p>
The code for finding the bounding box as well as input/output code
was written by Mike Baba (DBA Systems, 1990) and Jean Ezell (USACERL, 1988).
<p><i>Last changed: $Date: 2008-05-16 12:09:06 -0700 (Fri, 16 May 2008) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2013 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
|