/usr/share/doc/grass-doc/html/r.distance.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 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS manual: r.distance</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.distance</b></em> - Locates the closest points between objects in two raster maps.
<h2>KEYWORDS</h2>
raster, distance
<h2>SYNOPSIS</h2>
<b>r.distance</b><br>
<b>r.distance help</b><br>
<b>r.distance</b> [-<b>loq</b>] <b>maps</b>=<em>map1,map2</em>[,<i>map1,map2</i>,...] [<b>fs</b>=<em>string</em>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-l</b></DT>
<DD>Include category labels in the output</DD>
<DT><b>-o</b></DT>
<DD>Report zero distance if rasters are overlapping</DD>
<DT><b>-q</b></DT>
<DD>Run quietly</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>maps</b>=<em>map1,map2[,<i>map1,map2</i>,...]</em></DT>
<DD>Maps for computing inter-class distances</DD>
<DT><b>fs</b>=<em>string</em></DT>
<DD>Output field separator</DD>
<DD>Default: <em>:</em></DD>
</DL>
<h2>DESCRIPTION</h2>
<em>r.distance</em> locates the closest points between "objects" in two raster maps. An
"object" is defined as all the grid cells that have the same category
number, and closest means having the shortest "straight-line" distance.
The cell centers are considered for the distance calculation (two
adjacent grid cells have the distance between their cell centers).
<p>
The output is an ascii list, one line per pair of objects, in the following form:
<div class="code"><pre>
cat1:cat2:distance:east1:north1:east2:north2
</pre></div>
<dl>
<dt><b>cat1</b>
<dd>Category number from map1
<dt><b>cat2</b>
<dd>Category number from map2
<dt><b>distance</b>
<dd>The distance in meters between "cat1" and "cat2"
<dt><b>east1,north1</b>
<dd>The coordinates of the grid cell "cat1" which is closest to "cat2"
<dt><b>east2,north2</b>
<dd>The coordinates of the grid cell "cat2" which is closest to "cat1"
</dl>
<h3>Flags</h3>
<b>-l</b>
The -l flag outputs the category labels of the matched raster objects at the
beginning of the line, if they exist.
<p>
<b>-o</b>
The -o flag reports zero distance if the input rasters are overlapping.
<p>
<h2>NOTES</h2>
The output format lends itself to filtering. For example, to "see" lines
connecting each of the category pairs in two maps, filter the output using
awk and then into <em>d.graph</em>:
<p>
<div class="code"><pre>r.distance maps=map1,map2 | \
awk -F: '{print "move",$4,$5,"\ndraw",$6,$7}' | d.graph -m</pre></div>
<p>
To create a vector map of all the "map1" coordinates, filter the output into
awk and then into <em>v.in.ascii</em>:
<p>
<div class="code"><pre>r.distance maps=map1,map2 | \
<br>awk -F: '{print $4,$5}' | v.in.ascii format=point output=name fs=space</pre></div>
<h2>SEE ALSO</h2>
<em><a href="r.buffer.html">r.buffer</a></em>,
<em><a href="r.cost.html">r.cost</a></em>,
<em><a href="r.drain.html">r.drain</a></em>,
<em><a href="v.distance.html">v.distance</a></em>
<h2>AUTHOR</h2>
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
<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="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>
|