Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
r.li.pielou(1)		    GRASS GIS User's Manual		r.li.pielou(1)

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 input=name config=name output=name  [--overwrite]  [--help]
       [--verbose]  [--quiet]  [--ui]

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

       --help
	   Print usage summary

       --verbose
	   Verbose module output

       --quiet
	   Quiet module	output

       --ui
	   Force launching GUI dialog

   Parameters:
       input=nameA [required]
	   Name	of input raster	map

       config=nameA [required]
	   Configuration file

       output=nameA [required]
	   Name	for output raster map

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

	   o   J: Pielou eveness index

	   o   H': Shannon index

	   o   S: number of classes

NOTES
       Do not use absolute path	names for the config and output	 file/map  pa-
       rameters.    If	 the   "moving	 window"   method   was	  selected  in
       g.gui.rlisetup, then the	output will be	a  raster  map,	 otherwise  an
       ASCII  file  will  be  generated	 in  the  folder  C:\Users\userxy\App-
       Data\Roaming\GRASS7\r.li\output\		   (MS-Windows)		    or
       $HOME/.grass7/r.li/output/ (GNU/Linux).

       If the input raster contains NULL value cells, r.li.pielou returns NULL
       for these cells.

EXAMPLES
       To calculate Pielou's diversity index on	map my_map, using my_conf con-
       figuration file (previously defined with	g.gui.rlisetup)	and saving re-
       sults in	my_out,	run:
       r.li.pielou input=my_map	conf=my_conf output=my_out

       Forest map (Spearfish sample dataset) example:
       g.region	raster=landcover.30m -p
       r.mapcalc "forests = if(landcover.30m >=	41 && landcover.30m <= 43,1,null())"
       r.li.pielou input=forests conf=movwindow7 out=forests_pielou_mov7
       r.univar	forests_pielou_mov7

       Forest map (North Carolina sample dataset) example:
       g.region	raster=landclass96 -p
       r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
       r.li.pielou input=forests conf=movwindow7 out=forests_pielou_mov7
       # verify
       r.univar	forests_pielou_mov7
       r.to.vect input=forests output=forests type=area
       d.mon wx0
       d.rast forests_pielou_mov7
       d.vect forests type=boundary

SEE ALSO
	r.li - package overview
       g.gui.rlisetup

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

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).

SOURCE CODE
       Available at: r.li.pielou source	code (history)

       Main index | Raster index | Topics index	| Keywords index  |  Graphical
       index | Full index

       A(C) 2003-2020 GRASS Development	Team, GRASS GIS	7.8.3 Reference	Manual

GRASS 7.8.3							r.li.pielou(1)

NAME | KEYWORDS | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLES | SEE ALSO | REFERENCES | AUTHORS | SOURCE CODE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=r.li.pielou&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help