<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: r.li.shannon</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.li.shannon</b></em> - Calculates Shannon's diversity index on a raster map <h2>KEYWORDS</h2> raster, landscape structure analysis, diversity index <h2>SYNOPSIS</h2> <b>r.li.shannon</b><br> <b>r.li.shannon help</b><br> <b>r.li.shannon</b> <b>map</b>=<em>name</em> <b>conf</b>=<em>string</em> <b>output</b>=<em>name</em> [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>--overwrite</b></DT> <DD>Allow output files to overwrite existing files</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>map</b>=<em>name</em></DT> <DD>Name of input raster map</DD> <DT><b>conf</b>=<em>string</em></DT> <DD>Configuration file</DD> <DT><b>output</b>=<em>name</em></DT> <DD>Name for output raster map</DD> </DL> <h2>DESCRIPTION</h2> <em>r.li.shannon</em> calculates the "shannon's diversity index" as: <br> <img src="rliShannon_formula.png"><br> with:<br> <ul> <li><b>i</b>: patch type<br></li> <li><b>m</b>: number of patch type<br></li> <li><b>p<small><small>i</small></small></b>: proportion of the landscape occupied by patch type i<br></li> </ul> <h2>REFERENCES</h2> McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern analysis program for quantifying landscape structure. USDA For. Serv. Gen. Tech. Rep. PNW-351. <h2>EXAMPLES</h2> To calculate shannon's diversity index on map my_map, using my_conf configuration file and saving results in my_out file run:<br> <div class="code"><pre> r.li.shannon map=my_map conf=my_conf output=my_out </pre></div> <h2>NOTES</h2> Do not use absolute path names for output files. They are raster if moving window disposition was selected, otherwise they are in ~/.r.li/output folder. <br> If input raster is full of null values r.li.shannon returns -1. <br> If you want to have null values instead run <br> <div class="code"><pre> r.null setnull=-1 map=my_map </pre></div> after index calculation. <h2>SEE ALSO</h2> <em> <a href="r.li.html">r.li</a> </em> <h2>AUTHORS</h2> Serena Pallecchi student of Computer Science University of Pisa (Italy).<br> Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it) <h2>BUGS</h2> Please send bugs reports to <a href="mailto:pallecch@cli.di.unipi.it">pallecch@cli.di.unipi.it</a><br> <p><i>Last changed: $Date: 2007-02-08 17:52:53 +0100 (Thu, 08 Feb 2007) $</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-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>
