1r.li.setup(1) Grass User's Manual r.li.setup(1)
2
6 r.li.setup - Configuration editor for r.li.'index'
7
9 raster, landscape structure analysis
10
12 r.li.setup
13 r.li.setup help
14 r.li.setup [--verbose] [--quiet]
15
17 r.li.setup creates and shows configuration files for the others r.li
18 programs. For a general introduction, see r.li.
19 The configurations are raster map independent, it means that you can
20 use a file created on a raster map for analyze any other you have.
21 The program is completly interactive and uses a GUI to help you in your
22 choices.
23 Analysis methods
25 Definition of region for analysis:
26 Whole maplayer: entire map (current region),
28 Keyboard setting: based on keyboard selection for region
30 definition,
31 Draw the sampling frame: based on interactive region
33 selection via mouse.
34 Definition of creation of sampling area:
35 Whole maplayer: use entire area selected above,
37 Regions: select one to many subareas via mouse,
39 Sample units: automated selection of sampling area (for
41 details see below)
42 Random nonoverlapping,
44 Systematic contiguous,
46 Systematic noncontiguous,
48 Stratified random,
50 Centered over sites (vector points).
52 Moving window: rectagular or circular with size Select areas
53 from the overlayed vector map (for details see below)
54 Usage details
56 The startup window shows your configuration files, you can:
57 1 Load a file: the configuration is printed using rectangles with
59 differents colors (green for the raster map, red for the sample
60 frame and blue for the sample areas), and other notes (disposi‐
61 tion of sample areas etc). The configuration file is saved in
62 ~/.r.li/history/my_conf. Configuration output files are raster
63 if moving window disposition was selected, otherwise they are in
64 ~/.r.li/output folder.
65 All dimension are percentage of raster rows or columns.
67 2 Create a new file: this create a new configuration file in an
69 interactive way, in three steps
70 2.1
73 Choose file name and maps to use for setting:
74 Configuration file name (required): the name of new con‐
76 figuration file
77 Raster map name (required): the name of raster map to
79 use for setting
80 Vector map to overlay (optional): name of a vector map
82 to overlay in setting
83 Site file to overlay (optional): name of vector map of
85 points type to overlay in setting
86 2.6
88 Set the sampling frame. The sample frame is a rectangular area
89 which contains all the areas to analyze. It can be defined in
90 three ways:
91 Whole map layer: the sample frame is the whole map
93 Keyboard setting: the user enters the coordinates in
95 cells of upper left corner of sampling frame and its
96 length in rows and columns
97 Draw the sample frame: the user draws the sample frame on
99 map using mouse.
100 2.10
102 Set the sample areas. The sample areas are simply the areas to
103 analyze. They can be defined in five ways (see the picture
104 below):
105 Whole map layer: the sample area is the whole sample
107 frame
108 Regions: the user enters the number of areas and then
110 draws them using mouse.
111 Sample units: they are areas of rectangular or circular
113 shape. The user can define them using keyboard or mouse.
114 keyboard: the user define the shape of sample
116 unists and their disposition:
117 Random non overlapping: the user specifies
119 the number of sample units and they are
120 placed in a random way at runtime. It is
121 guaranted that the areas do not intersect
122 themselfs.
123 Systematic contiguous: the defined sample
125 is placed covering the sample frame, side
126 by side across rows.
127 Systematic non contiguous: the same as
129 above, but here ever rectangle is spaced
130 from another by a specified number of cells
131 Stratified random: the sample frame is
133 divided in n strats of rows and m strats of
134 columns (n and m are given by user), then
135 the specified number of sample areas are
136 placed in a random way, one for every m*n
137 areas defined by strats.
138 Centered over sites: the sample areas are
140 placed into sample frame centering them on
141 points in site file.
142 2.20 mouse: the user chooses the shape and then draws
144 the specified number of sample areas on map.
145 2.21 Moving Window: the user defines a rectangular or circular
147 area, it is moved over all the raster increasing only of
148 a cell for every move(in columns if possible, if not in
149 rows). It produces a new raster containing the result of
150 all analysis.
151 2.22 Select areas from the overlayed vector map: the sample
153 areas are defined by the vector map selected above. For
154 every cat in vector map, the procedure prompts the user
155 if he wants to include it as sample area. The resulting
156 configuration file can be used only with the specified
157 raster map, and the procedure can be used only if whole
158 map layer is selected as sampling frame.
159 3 Remove a file the selected file is deleted from the
161 available configuration files.
162 4 Help: open this help text.
164 5 Close module window.
166
168 Configuration files are raster map independent because areas are saved
169 using relative coordinates.
170
172 old r.le manual
173 r.li package overview
174 r.li.daemon, r.li.patchdensity
175
177 Claudio Porta & Lucio Davide Spano, students of Computer Science Uni‐
178 versity of Pisa (Italy).
179 Commission from Faunalia Pontedera (PI)
180 Rebuild of r.le.setup from William L. Baker
181
183 Pleas send bugs reports to spano@cli.di.unipi.it, porta@cli.di.unipi.it
184 cavallini@faunalia.it
185 Last changed: $Date: 2007-03-11 22:00:57 +0100 (Sun, 11 Mar 2007) $
187 Full index
189 © 2003-2008 GRASS Development Team
191GRASS 6.3.0 r.li.setup(1)