
NAME
r.li - package overview
DESCRIPTION
The r.li suite is a toolset for multiscale analysis of landscape structure.
How to calculate an index in a raster map:
- run r.li.setup: create a configuration file selecting the parts of
raster to analyze.
- run r.li.'index' (e.g., r.li.patchdensity) for calculate the selected
index using on the areas selected on configuration file.
NOTE
Also the r.li.daemon has a main function and it can be run, but it is only a
template for development of new indices.
The function itself has no meaning, it can be used only for debug.
EXAMPLE
To calculate a patch density index on a whole 'geology' raster map in the
Spearfish region, using a 5x5 moving window, follow this procedure:
- CREATE A NEW CONFIGURATION FILE
- run
- The main r.li.setup window is displayed, click on "New"
- Now it is displayed the new configuration window,
enter the configuration file name (e.g., "my_conf", do not use absolute paths)
and the name of raster map (e.g., "geology").
The other fields are not needed for this configuration.
- Click on "Setup sampling frame", select "Whole maplayer" and click "OK"
- Click on "Setup sampling areas", select "Moving window" and click "OK"
- Click on "Use keyboard to enter moving window dimension"
- Select "Rectangle" and enter 5 on "heigth" and "width" fields
- Click on "Save settings"
- Close r.li.setup window
- CALCULATE PATCHDENSITY INDEX
- set region settings to geology raster map:
- run r.li.patchdensity:
r.li.patchdensity map=geology conf=my_conf out=patchdens
The resulting patch density is stored in "patchdens" raster map.
You can verify the result for example with contour lines:
r.contour in=patchdens out=patchdens step=5
d.rast patchdens
d.vect -c patchdens
Note that if you want to run another index with the same area
configuration, you don't have to create another configuration file.
You can also use the same area configuration file on another map. The
program rescale it automatically. For instance if you have selected a
5x5 sample area on 100x100 raster map, and you use the same
configuration file on a 200x200 raster map, then the sample area is
10x10.
SEE ALSO
Core modules:
Patch indices:
- Indices based on patch number:
- r.li.patchdensity: Calculates patch density index on a raster map, using a 4 neighbour algorithm
- r.li.patchnum: Calculates patch number index on a raster map, using a 4 neighbour algorithm
- Indices based on patch dimension:
- r.li.mps: Calculates mean patch size index on a raster map, using a 4 neighbour algorithm
- r.li.padcv: Calculates coefficient of variation of patch area on a raster map
- r.li.padrange: Calculates range of patch area size on a raster map
- r.li.padsd: Calculates standard deviation of patch area a raster map
- Indices based on patch shape:
- r.li.shape: Calculates shape index on a raster map
- Indices based on patch edge:
- r.li.edgedensity: Calculates edge density index on a raster map, using a 4 neighbour algorithm
- Indices based on patch attributes:
- r.li.cwed: Calculates contrast Weighted Edge Density index on a raster map
- r.li.mpa: Calculates mean pixel attribute index on a raster map
Diversity indices:
- r.li.dominance: Calculates dominance's diversity index on a raster map
- r.li.richness: Calculates dominance's diversity index on a raster map
- r.li.shannon: Calculates Shannon's diversity index on a raster map
- r.li.simpson: Calculates Simpson's diversity index on a raster map
AUTHORS
Claudio Porta and Lucio Davide Spano, students of Computer Science
University of Pisa (Italy).
Commission from Faunalia Pontedera (PI)
BUGS
Please send bugs reports to
spano@cli.di.unipi.it,
porta@cli.di.unipi.it
Last changed: $Date: 2007/02/16 11:43:14 $
Main index - raster index - Full index