← Back to branch summary

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

« back to all changes in this revision

Viewing changes to raster/r.li/r.li.edgedensity/description.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:
raster/r.li/r.li.edgedensity/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>r.li.edgedensity </em>calculates:<br>
4
 
<br>
5
 
<ul>
6
 
   <li> the density of all edges of patch type <em>k</em>
7
 
        <img alt="rliEdgeDensity formula1" src="rliEdgeDensity_formula1.png">
8
 
        , or
9
 
   <li> the density of all edges in the sampling area if <em>k</em> is 
10
 
        not specified,
11
 
        <img alt="rliEdgeDensity formula2" src="rliEdgeDensity_formula2.png">
12
 
</ul>
13
 
<p>with:
14
 
<ul>
15
 
<li><b>k</b>: patch type</li>
16
 
<li><b>m</b>: number of patch types</li>
17
 
<li><b>n</b>: number of edge segments of patch type k</li>
18
 
<li><b>e<small><small>ik </small></small></b>:total edge length in 
19
 
the landscape involving patch type k</li>
20
 
<li> <b>Area</b>: total landscape area</li>
21
 
</ul>
22
 
 
23
 
<h2>NOTES</h2>
24
 
 
25
 
Do not use absolute path names for the <b>output</b> map/file.
26
 
If the "moving window" method was selected in <b>r.li.setup</b>, then the
27
 
output will be a raster map, otherwise an ASCII file will be generated in
28
 
the <tt>$HOME/.r.li/output/</tt> folder.
29
 
<p>
30
 
<!-- TODO: verify next: -->
31
 
If the input raster map contains only NULL values then <em>r.li.edgedensity</em>
32
 
consider to have 0 patches.<br>
33
 
If area is 0 <em>r.li.edgedensity</em> returns -1; this is only possible if input
34
 
raster is masked.
35
 
If you want to change these -1 values to NULL, run subsequently on the resulting map:
36
 
<div class="code"><pre>
37
 
r.null setnull=-1 map=my_map
38
 
</pre></div>
39
 
after index calculation.
40
 
 
41
 
<h2>EXAMPLES</h2>
42
 
To calculate the edge density index on map <em>my_map</em>, using
43
 
<em>my_conf</em> configuration file (previously defined with
44
 
<em>r.li.setup</em>) and saving results in <em>my_out</em>, run:
45
 
<div class="code"><pre>
46
 
r.li.edgedensity map=my_map conf=my_conf output=my_out
47
 
</pre></div>
48
 
 
49
 
To calculate edge density index of patch_type 34, using
50
 
"my_conf" configuration file and on map "my_map", saving results in "my_out"
51
 
file run:<br>
52
 
<div class="code"><pre>
53
 
r.li.edgedensity map=my_map conf=my_conf output=my_out patch_type=34
54
 
</pre></div>
55
 
<p>
56
 
 
57
 
Forest map (Spearfish sample dataset) example:
58
 
<div class="code"><pre>
59
 
g.region rast=landcover.30m -p
60
 
r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
61
 
r.li.edgedensity map=forests conf=movwindow7 out=forests_edgedens_mov7
62
 
r.univar forests_edgedens_mov7
63
 
</pre></div>
64
 
 
65
 
<h2>SEE ALSO</h2>
66
 
<em>
67
 
<a href="r.li.html">r.li</a> - package overview<br>
68
 
<a href="r.li.setup.html">r.li.setup</a>
69
 
</em>
70
 
 
71
 
<h2>REFERENCES</h2>
72
 
McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern
73
 
analysis program for quantifying landscape structure. USDA For. Serv.
74
 
Gen. Tech. Rep. PNW-351. (<a href="http://treesearch.fs.fed.us/pubs/3064">PDF</a>)
75
 
 
76
 
<h2>AUTHORS</h2>
77
 
Serena Pallecchi student of Computer Science University of Pisa (Italy).<br>
78
 
Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)
79
 
 
80
 
<p>
81
 
<i>Last changed: $Date: 2014-02-19 01:26:04 +0100 (Wed, 19 Feb 2014) $</i>