## 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$