DESCRIPTION

The g.gui.rlisetup is a wxGUI component which allows the user to create a configuration file for the analytical r.li modules. For a general introduction, see r.li.
The configurations are raster map independent, it means that you can use a file created on a raster map for analyze any other you have.
The program is completely interactive and uses a GUI to help you in your choices.

TODO: merge in material from GRASS GIS 6 (raster/r.li/r.li.setup/r.li.setup.html)

NOTES

Configuration files are raster map independent because areas are saved using relative coordinates.

EXAMPLES

Moving window analysis on full region

TODO: update examples to new g.gui.rlisetup dialog:

Example for a 7x7 moving window analysis on full region, the output is a raster map:

Click on "New", then:

Configuration file name: "movwindow7"
Raster map name to use to select areas: "forests"

1. Setup sampling frame:

Define a sampling frame (region for analysis): "Whole map layer", then "OK"

2. Setup sampling frame

Define sampling areas: "Moving window", then "OK"
Then click on "Use keyboard to define moving window dimension"

Select type of shape:

[x] Rectangular
Width size (in cells)?: "7"
Height size (in cells)?: "7"
Then "Save settings"

3. Save settings: click on button
(4.) Close

Now an anaysis can be performed using one of the analytical modules, e.g.

g.region rast=forests -p
r.li.patchdensity input=forests conf=movwindow7 output=forests_p_dens7
r.univar forests_p_dens7

The result is the new raster map "forests_p_dens7" which shows (in this example) the patch density of the forest areas.
See the respective modules for further examples.

Whole region analysis

Example for a whole region analysis, the output is a text file: Click on "New", then:

Configuration file name: "whole_region"
Raster map name to use to select areas: "lsat7_2000_40"

1. Setup sampling frame:

Define a sampling frame (region for analysis): "Whole map layer", then "OK"

2. Setup sampling frame

Define sampling areas: "Whole map layer", then "OK"

3. Save settings: click on button
(4.) Close

Now an anaysis can be performed using one of the analytical modules, e.g.

g.region rast=lsat7_2002_40 -p
r.li.shannon input=lsat7_2000_40 conf=whole_region output=lsat7_2000_40_shannon

The result is the new text file "forests_p_dens7" (stored in folder $HOME/.r.li/output/.
See the respective modules for further examples.

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)

AUTHOR

Luca Delucchi
Rewritten from r.li.setup by Claudio Porta and Lucio Davide Spano

$Date$