1wxGUI.rlisetup(1)           GRASS GIS User's Manual          wxGUI.rlisetup(1)
2
3
4

wxGUI RLi Setup

DESCRIPTION

7       The g.gui.rlisetup is a wxGUI component which allows the user to create
8       a configuration file for the analytical r.li modules. For a general in‐
9       troduction, see the r.li overview.
10       The  configurations  are  raster map independent, it means that you can
11       use a file created on a raster map for analyze any other you have.
12       The program is completely interactive and uses a GUI  to  help  you  in
13       your choices.
14
15   Analysis methods
16       Definition of creation of sampling area:
17
18           •   Whole map layer: use entire area selected above,
19
20           •   Regions: select one to many subareas via mouse,
21
22           •   Sample units: automated selection of sampling area (for details
23               see below)
24
25               •   Random nonoverlapping,
26
27               •   Systematic contiguous,
28
29               •   Systematic noncontiguous,
30
31               •   Stratified random,
32
33               •   Centered over sites (vector points).
34
35           •   Moving window: rectangular or circular with size
36
37       Definition of region for analysis:
38
39           •   Whole map layer: entire map (current region),
40
41           •   Keyboard setting: based on keyboard selection for region  defi‐
42               nition,
43
44           •   Draw  the sampling frame: based on interactive region selection
45               via mouse.
46
47   Usage details
48       The startup window shows your configuration files, you can:
49
50       TODO: description below needs further updates
51
52       1      View/Edit (Load a file) from the shown list:  the  configuration
53              is shown in a small text editor window.  Configuration files are
54              saved in the folder C:\Users\userxy\AppData\Roaming\GRASS8\r.li\
55              (MS-Windows)  or  $HOME/.r.li/ (GNU/Linux) (the file name can be
56              defined by the user). The output or an analysis can either be  a
57              new  raster map (in case of using a "moving window" analysis) or
58              be an ASCII text file (when not  performing  a  "moving  window"
59              analysis)  containing  the result.  Such text file will be saved
60              in the  folder  C:\Users\userxy\AppData\Roaming\GRASS8\r.li\out‐
61              put\ (MS-Windows) or $HOME/.grass8/r.li/output/ (GNU/Linux).
62              All dimensions are percentages of raster rows or columns.
63
64       2      Create a new configuration file: used for creating a new config‐
65              uration file in an interactive way, in three steps:
66
67       2.1    Choose file name and maps to use for setting:
68
69Name for new configuration file(required): the name of new con‐
70               figuration file
71
72Raster  map name to use to select areas (required): the name of
73               raster map used for selecting sampling areas
74
75Vector map to overlay (optional): name of a vector map used for
76               selecting sampling areas
77
78       2.2    Set  the  sampling frame. The sample frame is a rectangular area
79              which contains all the areas to analyze. It can  be  defined  in
80              three ways:
81
82Whole map layer: the sample frame is the whole map
83
84Keyboard  setting:  the user enters the coordinates in cells of
85               upper left corner of sampling frame and its length in rows  and
86               columns.
87
88Draw  the  sample frame: the user draws the sample frame on map
89               using mouse.
90
91       2.3    Set the sample areas. The sample areas are simply the  areas  to
92              analyze.  They  can be defined in five ways (see the picture be‐
93              low):
94
95Whole map layer: the sample area is the whole sample frame
96
97Regions: the user enters the number of  areas  and  then  draws
98               them using mouse.
99
100Sample  units: they are areas of rectangular or circular shape.
101               The user can define them using keyboard or mouse.
102
103               •   keyboard: the user define the shape of  sample  unists  and
104                   their disposition:
105
106Random  non  overlapping: the user specifies the number
107                       of sample units and they are placed in a random way  at
108                       runtime.  It is guaranteed that the areas do not inter‐
109                       sect themselves.
110
111Systematic contiguous: the  defined  sample  is  placed
112                       covering the sample frame, side by side across rows.
113
114Systematic  non contiguous: the same as above, but here
115                       ever rectangle is spaced from another  by  a  specified
116                       number of cells.
117
118Stratified  random:  the  sample  frame is divided in n
119                       strats of rows and m strats of columns  (n  and  m  are
120                       given by user), then the specified number of sample ar‐
121                       eas are placed in a random way, one for every m*n areas
122                       defined by strats.
123
124Centered  over  sites: the sample areas are placed into
125                       sample frame centering them on points in site file.
126
127               •   mouse: the user chooses the shape and then draws the speci‐
128                   fied number of sample areas on map.
129
130Moving Window: the user defines a rectangular or circular area,
131               it is moved over all the raster increasing only of a  cell  for
132               every  move(in  columns  if possible, if not in rows).  It pro‐
133               duces a new raster containing the result of all analysis.
134
135Select areas from the overlaid vector map: the sample areas are
136               defined  by  the  vector  map selected above.  For every cat in
137               vector map, the procedure prompts the user if they want to  in‐
138               clude  it as sample area.  The resulting configuration file can
139               be used only with the specified raster map, and  the  procedure
140               can  be  used  only  if whole map layer is selected as sampling
141               frame.
142
143       3      Remove a file the selected file is deleted  from  the  available
144              configuration files.
145
146       4      Help: open this help text.
147
148       5      Close module window.
149

NOTES

151       Configuration  files are raster map independent because areas are saved
152       using relative coordinates.
153
154       Screenshots of the wizard window frames:
155
156         g.gui.rlisetup: First frame of wizard for  selecting  ex‐   g.gui.rlisetup: Frame for selecting maps
157       isting configuration files or creating a new one
158
159         g.gui.rlisetup: Frame for inserting sampling areas           g.gui.rlisetup:  Frame  for  defining rectangular moving
160                                                                    window
161
162         g.gui.rlisetup: Frame for defining circular moving window   g.gui.rlisetup: Frame for  choosing  the  sampling  frame
163                                                                    with keyboard
164
165         g.gui.rlisetup: Frame for drawing the sampling frame        g.gui.rlisetup: Summary frame before saving
166
167

EXAMPLES

169   Moving window analysis on full region
170       TODO: update examples to new g.gui.rlisetup dialog:
171
172       Example  for a 7x7 moving window analysis on full region, the output is
173       a raster map:
174
175       Click on "New", then:
176
177           •   Configuration file name: "movwindow7"
178
179           •   Raster map name to use to select areas: "forests"
180       1. Setup sampling frame:
181
182           •   Define a sampling  frame  (region  for  analysis):  "Whole  map
183               layer", then "OK"
184       2. Setup sampling frame
185
186           •   Define sampling areas: "Moving window", then "OK"
187
188           •   Then click on "Use keyboard to define moving window dimension"
189       Select type of shape:
190
191           •   [x] Rectangular
192
193           •   Width size (in cells)?: "7"
194
195           •   Height size (in cells)?: "7"
196
197           •   Then "Save settings"
198       3. Save settings: click on button
199       (4.) Close
200
201       Now  an  anaysis  can be performed using one of the analytical modules,
202       e.g.
203       g.region raster=forests -p
204       r.li.patchdensity input=forests conf=movwindow7 output=forests_p_dens7
205       r.univar forests_p_dens7
206       The result is the new raster map "forests_p_dens7" which shows (in this
207       example) the patch density of the forest areas.
208       See the respective modules for further examples.
209
210   Whole region analysis
211       Example  for  a whole region analysis, the output is a text file: Click
212       on "New", then:
213
214           •   Configuration file name: "whole_region"
215
216           •   Raster map name to use to select areas: "lsat7_2000_40"
217       1. Setup sampling frame:
218
219           •   Define a sampling  frame  (region  for  analysis):  "Whole  map
220               layer", then "OK"
221       2. Setup sampling frame
222
223           •   Define sampling areas: "Whole map layer", then "OK"
224       3. Save settings: click on button
225       (4.) Close
226
227       Now  an  anaysis  can be performed using one of the analytical modules,
228       e.g.
229       g.region raster=lsat7_2002_40 -p
230       r.li.shannon input=lsat7_2000_40 conf=whole_region output=lsat7_2000_40_shannon
231       The result is the new text file  "forests_p_dens7"  (stored  in  folder
232       $HOME/.r.li/output/.
233       See the respective modules for further examples.
234

REFERENCES

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

SEE ALSO

241        r.li - package overview
242       r.li.daemon
243
244        Old r.le suite manual (1992)
245
246        wxGUI, wxGUI components
247

AUTHORS

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

SOURCE CODE

253       Available at: wxGUI RLi Setup source code (history)
254
255       Accessed: Mon Jun 20 16:48:30 2022
256
257       Main  index | GUI index | Topics index | Keywords index | Graphical in‐
258       dex | Full index
259
260       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
261
262
263
264GRASS 8.2.0                                                  wxGUI.rlisetup(1)
Impressum