/usr/share/doc/grass-doc/html/i.zc.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 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS manual: i.zc</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>i.zc</b></em> - Zero-crossing "edge detection" raster function for image processing.
<h2>KEYWORDS</h2>
imagery, edges
<h2>SYNOPSIS</h2>
<b>i.zc</b><br>
<b>i.zc help</b><br>
<b>i.zc</b> <b>input</b>=<em>string</em> <b>output</b>=<em>string</em> [<b>width</b>=<em>integer</em>] [<b>threshold</b>=<em>float</em>] [<b>orientations</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>string</em></DT>
<DD>Name of input raster map</DD>
<DT><b>output</b>=<em>string</em></DT>
<DD>Zero crossing raster map</DD>
<DT><b>width</b>=<em>integer</em></DT>
<DD>x-y extent of the Gaussian filter</DD>
<DD>Default: <em>9</em></DD>
<DT><b>threshold</b>=<em>float</em></DT>
<DD>Sensitivity of Gaussian filter</DD>
<DD>Default: <em>10</em></DD>
<DT><b>orientations</b>=<em>integer</em></DT>
<DD>Number of azimuth directions categorized</DD>
<DD>Default: <em>1</em></DD>
</DL>
<h2>DESCRIPTION</h2>
<em>i.zc</em> is an image processing program used for edge
detection. The raster map produced shows the location of
"boundaries" on the input map. Boundaries tend to be found
in regions of changing cell values and tend to run
perpendicular to the direction of the slope. The algorithm
used for edge detection is one of the "zero-crossing"
algorithms and is discussed briefly below.
<h2>OPTIONS</h2>
<h3>Parameters:</h3>
<dl>
<dt><b>input_map=</b><em>name</em>
<dd>Name of input raster map layer.
<dt><b>zc_map=</b><em>name</em>
<dd>Name of raster map layer to be used for zero-crossing values.
<dt><b>width=</b><em>value</em>
<dd>This parameter determines the x-y extent of the
Gaussian filter. The default value is 9; higher and lower
values can be tested by the user. Increasing the width
will result in finding "edges" representing more gradual
changes in cell values.
<br>
Default: 9
<dt><b>threshold=</b><em>value</em>
<dd>This parameter determines the "sensitivity" of the
Gaussian filter. The default value is 10; higher and
lower values can be tested by the user. Increasing the
threshold value will result in fewer edges being found.
<br>
Default: 10
<dt><b>orientations=</b><em>value</em>
<dd>This value is the number of azimuth directions the
cells on the output raster map layer are categorized into
(similar to the aspect raster map layer produced by the
<em><a href="r.slope.aspect.html">r.slope.aspect</a></em>
program). For example, a value of 16 would result in
detected edges being categorized into one of 16 bins
depending on the direction of the edge at that point.
<br>
Default: 1
</dl>
The current region definition and mask settings are respected
when reading the input map.
<h2>NOTES</h2>
The procedure to find the "edges" in the image is as follows:
<ol>
<li> The Fourier transform of the image is taken,
<li> The Fourier transform of the Laplacian of a two-dimensional
Gaussian function is used to filter the transformed image,
<li> The result is run through an inverse Fourier transform,
<li> The resulting image is traversed in search of places where the image
changes from positive to negative or from negative to positive,
<li> Each cell in the map where the value crosses zero
(with a change in value greater than the threshold value)
is marked as an edge and an orientation is assigned to it.
The resulting raster map layer is output.
</ol>
<h2>SEE ALSO</h2>
<em><a href="i.fft.html">i.fft</a></em>,
<em><a href="i.ifft.html">i.ifft</a></em>,
<em><a href="r.mapcalc.html">r.mapcalc</a></em>,
<em><a href="r.mfilter.html">r.mfilter</a></em>,
<em><a href="r.slope.aspect.html">r.slope.aspect</a></em>
<h2>AUTHOR</h2>
David Satnik, GIS Laboratory,
Central Washington University
<p><i>Last changed: $Date: 2011-11-08 03:29:50 -0800 (Tue, 08 Nov 2011) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="imagery.html">imagery 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>
|