NAME

       r.li.pielou  - Calculates Pielou's diversity index on a raster map

KEYWORDS

       raster, landscape structure analysis, diversity index

SYNOPSIS

       r.li.pielou
       r.li.pielou help
       r.li.pielou map=name conf=string output=name  [--overwrite]  [--verbose]  [--quiet]

   Flags:
       --overwrite
           Allow output files to overwrite existing files

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       map=name
           Name of input raster map

       conf=string
           Configuration file

       output=name
           Name for output raster map

DESCRIPTION

       r.li.pielou  calculates the "pielou's diversity index" as:
       with:

                     J: Pielou eveness index

                     H': Shannon index

                     S: number of classes

NOTES

       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.
       If the input raster contains NULL value cells, r.li.pielou returns -1 for these cells.
       If you want to keep NULL values instead, run subsequently on the resulting map:

       r.null setnull=-1 map=my_map

EXAMPLES

       To calculate Pielou's diversity index on the map "my_map", using  the  previously  created
       "my_conf" configuration file (r.li.setup) and saving results in "my_out" raster map, run:

       r.li.pielou map=my_map conf=my_conf output=my_out

REFERENCES

       McGarigal,  K.,  and  B.  J.  Marks. 1995. FRAGSTATS: spatial pattern analysis program for
       quantifying landscape structure. USDA For. Serv.  Gen. Tech. Rep. PNW-351. (PDF)

SEE ALSO

        r.li, r.li.setup

AUTHORS

       Luca Delucchi and Duccio Rocchini, Fondazione E. Mach (Italy), based on  the  r.li.shannon
       code developed by Serena Pallecchi student of Computer Science University of Pisa (Italy).

       Last changed: $Date: 2010-11-24 08:49:21 -0800 (Wed, 24 Nov 2010) $

       Full index

       © 2003-2013 GRASS Development Team