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

« back to all changes in this revision

Viewing changes to raster/r.li/r.li.padrange/r.li.padrange.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.li.padrange</em> calculates the range of patch area sizes in 
 
4
hectares as:<br>
 
5
<img src="rlipadrange_formula.png" alt="r.li.padrange formula"> <br>
 
6
with:<br>
 
7
<ul>
 
8
  <li><b>a<small><small>max</small></small></b>: max patch area size</li>
 
9
  <li><b>a<small><small>min</small></small></b>: min patch area size</li>
 
10
</ul>
 
11
 
 
12
<p>
 
13
This index is calculated using a 4 neighbour algorithm, diagonal cells 
 
14
are ignored when tracing a patch.
 
15
 
 
16
<h2>NOTES</h2>
 
17
 
 
18
Do not use absolute path names for the <b>config</b> and <b>output</b>
 
19
file/map parameters.
 
20
 
 
21
If the "moving window" method was selected in <b>g.gui.rlisetup</b>, then the
 
22
output will be a raster map, otherwise an ASCII file will be generated in
 
23
the folder <tt>C:\Users\userxy\AppData\Roaming\GRASS7\r.li\output\</tt>
 
24
(MS-Windows) or <tt>$HOME/.grass7/r.li/output/</tt> (GNU/Linux).
 
25
<p>
 
26
If the sample area contains only NULL values then <em>r.li.padrange</em>
 
27
returns NULL.<br>
 
28
 
 
29
<h2>EXAMPLES</h2>
 
30
To calculate range of patch area size index on map <em>my_map</em>, using
 
31
<em>my_conf</em> configuration file (previously defined with
 
32
<em>g.gui.rlisetup</em>) and saving results in <em>my_out</em>, run:
 
33
<div class="code"><pre>
 
34
r.li.padrange input=my_map conf=my_conf output=my_out
 
35
</pre></div>
 
36
<p>
 
37
 
 
38
Forest map (Spearfish sample dataset) example:
 
39
<div class="code"><pre>
 
40
g.region raster=landcover.30m -p
 
41
r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
 
42
r.li.padrange input=forests conf=movwindow7 out=forests_padrange_mov7
 
43
r.univar forests_padrange_mov7
 
44
</pre></div>
 
45
<p>
 
46
 
 
47
Forest map (North Carolina sample dataset) example:
 
48
<div class="code"><pre>
 
49
g.region raster=landclass96 -p
 
50
r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
 
51
r.li.padrange input=forests conf=movwindow7 out=forests_padrange_mov7
 
52
 
 
53
# verify
 
54
r.univar forests_padrange_mov7
 
55
r.to.vect input=forests output=forests type=area
 
56
d.mon wx0
 
57
d.rast forests_padrange_mov7
 
58
d.vect forests type=boundary
 
59
</pre></div>
 
60
 
 
61
<h2>SEE ALSO</h2>
 
62
<em>
 
63
<a href="r.li.html">r.li</a> - package overview<br>
 
64
<a href="g.gui.rlisetup.html">g.gui.rlisetup</a>
 
65
</em>
 
66
 
 
67
<h2>REFERENCES</h2>
 
68
McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern
 
69
analysis program for quantifying landscape structure. USDA For. Serv.
 
70
Gen. Tech. Rep. PNW-351. (<a href="http://treesearch.fs.fed.us/pubs/3064">PDF</a>)
 
71
 
 
72
<h2>AUTHORS</h2>
 
73
Michael Shapiro - CERL (patch identification)<br>
 
74
Markus Metz (statistics)
 
75
 
 
76
<p>
 
77
<i>Last changed: $Date: 2014-12-19 22:55:37 +0100 (Fri, 19 Dec 2014) $</i></p>