Ubuntu Manpage: r.li.setup - Configuration editor for r.li.'index'

NAME

       r.li.setup  - Configuration editor for r.li.'index'

KEYWORDS

       raster, landscape structure analysis

SYNOPSIS

       r.li.setup
       r.li.setup help
       r.li.setup  [--verbose]  [--quiet]

DESCRIPTION

r.li.setup creates and shows configuration files for the others r.li programs. 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.

Analysis methods
Definition of region for analysis:

Whole maplayer: entire map (current region),

Keyboard setting: based on keyboard selection for region definition,

Draw the sampling frame: based on interactive region selection via mouse.
Definition of creation of sampling area:

Whole maplayer: use entire area selected above,

Regions: select one to many subareas via mouse,

Sample units: automated selection of sampling area (for details see below)

Random nonoverlapping,

Systematic contiguous,

Systematic noncontiguous,

Stratified random,

Centered over sites (vector points).
Moving window: rectagular or circular with size Select areas from the overlayed
vector map (for details see below)

Usage details
The startup window shows your configuration files, you can:

1 Load a file: the configuration is printed using rectangles with differents colors
(green for the raster map, red for the sample frame and blue for the sample areas),
and other notes (disposition of sample areas etc). The configuration file is saved
in ~/.r.li/history/my_conf. Configuration output files are raster if moving window
disposition was selected, otherwise they are in ~/.r.li/output folder.

All dimension are percentage of raster rows or columns.

2 Create a new file: this create a new configuration file in an interactive way, in
three steps

2.1
Choose file name and maps to use for setting:

Configuration file name (required): the name of new configuration file

Raster map name (required): the name of raster map to use for setting

Vector map to overlay (optional): name of a vector map to overlay in
setting

Site file to overlay (optional): name of vector map of points type to
overlay in setting

2.6
Set the sampling frame. The sample frame is a rectangular area which contains all
the areas to analyze. It can be defined in three ways:

Whole map layer: the sample frame is the whole map

Keyboard setting: the user enters the coordinates in cells of upper left
corner of sampling frame and its length in rows and columns.

Draw the sample frame: the user draws the sample frame on map using mouse.

2.10
Set the sample areas. The sample areas are simply the areas to analyze. They can
be defined in five ways (see the picture below):

Whole map layer: the sample area is the whole sample frame

Regions: the user enters the number of areas and then draws them using
mouse.

Sample units: they are areas of rectangular or circular shape. The user can
define them using keyboard or mouse.

keyboard: the user define the shape of sample unists and their
disposition:

Random non overlapping: the user specifies the number of
sample units and they are placed in a random way at runtime.
It is guaranted that the areas do not intersect themselfs.

Systematic contiguous: the defined sample is placed covering
the sample frame, side by side across rows.

Systematic non contiguous: the same as above, but here ever
rectangle is spaced from another by a specified number of
cells

Stratified random: the sample frame is divided in n strats of
rows and m strats of columns (n and m are given by user), then
the specified number of sample areas are placed in a random
way, one for every m*n areas defined by strats.

Centered over sites: the sample areas are placed into sample
frame centering them on points in site file.

2.20 mouse: the user chooses the shape and then draws the specified number
of sample areas on map.

2.21 Moving Window: the user defines a rectangular or circular area, it is moved
over all the raster increasing only of a cell for every move(in columns if
possible, if not in rows). It produces a new raster containing the result
of all analysis.

2.22 Select areas from the overlayed vector map: the sample areas are defined by
the vector map selected above. For every cat in vector map, the procedure
prompts the user if he wants to include it as sample area. The resulting
configuration file can be used only with the specified raster map, and the
procedure can be used only if whole map layer is selected as sampling frame.

3 Remove a file the selected file is deleted from the available configuration
files.

4 Help: open this help text.

5 Close module window.

NOTES

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

AUTHORS