~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to raster/r.param.scale/r.param.scale.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>r.param.scale</em> extracts terrain parameters from a digital elevation model. Uses a
 
4
multi-scale approach by fitting a bivariate quadratic polynomial to a given
 
5
window size using least squares.
 
6
 
 
7
<p>The module calculates the following parameters (terminology is from Wood,
 
8
1996 with related terminology used in other GRASS modules listed in
 
9
brackets):
 
10
<ul>
 
11
<li>
 
12
<i>elev</i>: Generalised elevation value (for resampling purposes at different
 
13
scale)</li>
 
14
 
 
15
<li>
 
16
<i>slope</i>: Magnitude of maximum gradient (steepest slope angle)</li>
 
17
 
 
18
<li>
 
19
<i>aspect</i>: Direction of maximum gradient (steepest slope direction=flow direction)</li>
 
20
 
 
21
<li>
 
22
<i>profc</i>: profile curvature (curvature intersecting with the plane
 
23
defined by <i>Z</i> axis and maximum gradient direction). Positive values
 
24
describe convex profile curvature, negative values concave profile
 
25
curvature.</li>
 
26
 
 
27
<li>
 
28
<i>planc</i>: plan curvature (horizontal curvature, intersecting with
 
29
the <i>XY</i> plane)</li>
 
30
 
 
31
<li>
 
32
<i>longc</i>: longitudinal curvature (profile curvature intersecting
 
33
with the plane defined by the surface normal and maximum gradient direction)</li>
 
34
 
 
35
<li>
 
36
<i>crosc</i>: cross-sectional curvature (tangential curvature intersecting
 
37
with the plane defined by the surface normal and a tangent to the contour
 
38
- perpendicular to maximum gradient direction)</li>
 
39
 
 
40
<li>
 
41
<i>maxic</i>: maximum curvature (can be in any direction)</li>
 
42
 
 
43
<li>
 
44
<i>minic</i>: minimum curvature (in direction perpendicular to the direction
 
45
of of maximum curvature)</li>
 
46
 
 
47
<!--
 
48
<li>
 
49
<i>meanc</i> or mean curvature (average of maximum and minimum curvatures).</li>
 
50
-->
 
51
 
 
52
<li>
 
53
<i>feature</i>: Morphometric features: peaks, ridges, passes, channels, pits and planes</li>
 
54
</ul>
 
55
 
 
56
<h2>NOTES</h2>
 
57
In <i>r.param.scale</i> the direction of maximum gradient (considered
 
58
downslope) is stored as (West is 0 degree, East is +/- 180 degree):
 
59
 
 
60
<ul>
 
61
<li>
 
62
0..+180 degree from West to North to East</li>
 
63
 
 
64
<li>
 
65
0..-180 degree from West to South to East</li>
 
66
</ul>
 
67
 
 
68
Note that the aspect map is calculated differently from
 
69
<em><a href="r.slope.aspect.html">r.slope.aspect</a></em>.
 
70
 
 
71
<h2>EXAMPLE</h2>
 
72
 
 
73
The next commands will create a geomorphological map of the Spearfish region:
 
74
 
 
75
<div class="code"><pre>
 
76
g.region raster=elevation.10m -p
 
77
r.param.scale in=elevation.10m output=morphology param=feature size=9
 
78
</pre></div>
 
79
 
 
80
<p><center>
 
81
<img src="r_param_scale_morph.jpg" alt="r.param.scale generated geomorphological map"><br>
 
82
<i>Geomorphological map of a subregion in the Spearfish (SD) area</i>
 
83
</center>
 
84
 
 
85
<h2>TODO</h2>
 
86
 
 
87
Fix bug when `constrain through central cell' option selected. Create color
 
88
tables for all output files (presently only on features).
 
89
 
 
90
<h2>REFERENCE</h2>
 
91
 
 
92
Wood, J. (1996): The Geomorphological characterisation of Digital Elevation
 
93
Models. Diss., Department of Geography, University of Leicester, U.K.
 
94
 
 
95
<br>online at:
 
96
<br><a href="http://www.soi.city.ac.uk/~jwo/phd/">http://www.soi.city.ac.uk/~jwo/phd/</a>
 
97
 
 
98
<p>Java Code in
 
99
<a href="http://www.geog.le.ac.uk/jwo/research/LandSerf">LandSerf</a>
 
100
that implements the same procedure
 
101
 
 
102
<h2>SEE ALSO</h2>
 
103
<!-- not ported to GRASS 6 due to non-GPLness of numerical recipes.
 
104
<i><a href="d.param.scale.html">d.param.scale</a></i>
 
105
-->
 
106
 
 
107
<em>
 
108
  <a href="r.slope.aspect.html">r.slope.aspect</a>
 
109
</em>
 
110
 
 
111
<h2>AUTHORS</h2>
 
112
 
 
113
<address>
 
114
<a href="MAILTO:jwo@le.ac.uk">jwo@le.ac.uk</a>
 
115
- <a href="http://www.geog.le.ac.uk/assist/index.html">ASSIST's home</a></address>
 
116
 
 
117
<p>Update to FP 3/2002: L. Potrich, M. Neteler, S. Menegon (ITC-irst)
 
118
 
 
119
<p>
 
120
<i>Last changed: $Date: 2014-12-19 22:55:37 +0100 (Fri, 19 Dec 2014) $</i>