[GRASS-SVN] r59419 - grass-addons/grass7/raster/r.stream.distance
svn_grass at osgeo.org
svn_grass at osgeo.org
Thu Mar 27 07:29:36 PDT 2014
Author: madi
Date: 2014-03-27 07:29:36 -0700 (Thu, 27 Mar 2014)
New Revision: 59419
Modified:
grass-addons/grass7/raster/r.stream.distance/r.stream.distance.html
Log:
consistency improved
Modified: grass-addons/grass7/raster/r.stream.distance/r.stream.distance.html
===================================================================
--- grass-addons/grass7/raster/r.stream.distance/r.stream.distance.html 2014-03-27 14:13:50 UTC (rev 59418)
+++ grass-addons/grass7/raster/r.stream.distance/r.stream.distance.html 2014-03-27 14:29:36 UTC (rev 59419)
@@ -1,41 +1,47 @@
<h2>OPTIONS</h2>
+
<dl>
<dt><b>-o</b></dt>
<dd>Outlets. Downstream method only. Calculate distance and relative elevation
to basin outlets instead of streams. It chooses only last outlets in the network
ignoring nodes.</dd>
+
<dt><b>-s</b></dt>
<dd>Subbasins. Downstream method only. Calculate distance and elevation to
stream nodes instead of streams. It creates distance and elevation parameters not
for whole basins but for all elementary subbasins.</dd>
+
<dt><b>-n</b></dt>
<dd>Near. For upstream method only. Calculate distance and elevation to the
nearest local maximum/divide. With the default option distance/elevation is
-calculated to the farthest possible maximum/divide.
-</dd>
-<dt><b>streams</b></dt>
+calculated to the farthest possible maximum/divide.</dd>
+
+
+<dt><b>stream_rast</b></dt>
<dd>Stream network: name of input stream map on which ordering will be performed,
produced by r.watershed or r.stream.extract. Because streams network produced by
r.watershed and r.stream.extract may slighty differ in detail it is required to
use both stream and direction map produced by the same module. Stream background
shall have NULL value or zero value. Background values of NULL are by default
produced by r.watershed and r.stream.extract. If not 0 or NULL use <a
-href="r.mapcalc.html">r.mapcalc</a> to set background values to NULL.
-</dd>
-<dt><b>dirs</b></dt>
+href="r.mapcalc.html">r.mapcalc</a> to set background values to NULL.</dd>
+
+<dt><b>direction</b></dt>
<dd>Flow direction: name of input direction map produced by r.watershed or
r.stream.extract. If r.stream.extract output map is used, it only has non-NULL
values in places where streams occur. NULL (nodata) cells are ignored, zero and
negative values are valid direction data if they vary from -8 to 8 (CCW from
East in steps of 45 degrees). Direction map shall be of type CELL values. Region
-resolution and map resoultion must be the same. Also <em>stream</em> network map
-must have the same resolution. It is checked by default. If resolutions differ
+resolution and map resoultion must be the same. Also <em>stream_rast</em> network map
+must have the same resolution. It is checked by default. If resolutions differ,
the module informs about it and stops. Region boundary and maps boundary may
differ but it may lead to unexpected results.</dd>
+
<dt><b>elevation</b></dt>
<dd>Elevation: name of input elevation map. Map can be of type CELL, FCELL or
DCELL. It is not restricted to resolution of region settings as stream and
-dir.</dd>
+direction.</dd>
+
<dt><b>method</b></dt>
<dd>It is possible to calculate distance with two method: <b>downstream</b> from
any raster cell to the nearest stream cell/ junction cell or outlet or
@@ -97,13 +103,13 @@
The module can work only if direction map, streams map and region have the same settings.
It is also required that streams map and direction map come from the same source.
For lots of reason this limitation probably cannot be omitted. This means that if
-stream map comes from r.stream.extract also direction map from r.stream.extract
+stream_rast map comes from r.stream.extract also direction map from r.stream.extract
must be used. If stream network was generated with MFD method also MFD direction
map must be used.
<p>
Probably one of the most imortant features of r.stream.distance is the ability to
calculate distance not only for streams generated with r.stream.extract, but also
-to any CELL map with resolution corresponding to dirs map. It can be a lake,
+to any CELL map with resolution corresponding to direction map. It can be a lake,
swamp, depression and lake boundaries even divided into smaller fragments each
with its own category.
@@ -111,9 +117,11 @@
<div class="code"><pre>
g.region -p -a rast=elevation align=elevation
-r.watershed elevation=elevation threshold=10000 drainage=dirs stream=streams
-r.stream.distance stream=streams dirs=dirs elevation=elevation method=downstream distance=distance_stream_downstream difference=difference_stream_downstream
-r.stream.distance stream=streams dirs=dirs elevation=elevation method=upstream distance=distance_stream_upstream difference=difference_stream_upstream
+r.watershed elevation=elevation threshold=10000 drainage=direction stream=streams
+r.stream.distance stream_rast=streams direction=direction elevation=elevation \
+method=downstream distance=distance_stream_downstream difference=difference_stream_downstream
+r.stream.distance stream_rast=streams direction=direction elevation=elevation \
+method=upstream distance=distance_stream_upstream difference=difference_stream_upstream
</pre></div>
<h2>SEE ALSO</h2>
More information about the grass-commit
mailing list