1wxGUI.rlisetup(1)             Grass 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
9       introduction, 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\GRASS7\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\GRASS7\r.li\out‐
61              put\ (MS-Windows) or $HOME/.grass7/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
69           ·   Name for new configuration file(required): the name of new con‐
70               figuration file
71
72           ·   Raster  map name to use to select areas (required): the name of
73               raster map used for selecting sampling areas
74
75           ·   Vector 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
82           ·   Whole map layer: the sample frame is the whole map
83
84           ·   Keyboard  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
88           ·   Draw  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
93              below):
94
95           ·   Whole map layer: the sample area is the whole sample frame
96
97           ·   Regions: the user enters the number of  areas  and  then  draws
98               them using mouse.
99
100           ·   Sample  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
106                   ·   Random  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
111                   ·   Systematic contiguous: the  defined  sample  is  placed
112                       covering the sample frame, side by side across rows.
113
114                   ·   Systematic  non contiguous: the same as above, but here
115                       ever rectangle is spaced from another  by  a  specified
116                       number of cells.
117
118                   ·   Stratified  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
121                       areas are placed in a random way,  one  for  every  m*n
122                       areas defined by strats.
123
124                   ·   Centered  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
130           ·   Moving 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
135           ·   Select 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
138               include  it  as  sample area.  The resulting configuration file
139               can be used only with the specified raster map, and the  proce‐
140               dure  can  be  used only if whole map layer is selected as sam‐
141               pling 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 existing g.gui.rlisetup: Frame for selecting maps
157       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 window
160
161       g.gui.rlisetup: Frame for defining circular moving window    g.gui.rlisetup:  Frame  for choosing the sampling frame with
162                                                                    keyboard
163
164       g.gui.rlisetup: Frame for drawing the sampling frame         g.gui.rlisetup: Summary frame before saving
165
166

EXAMPLES

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

SEE ALSO

235        r.li - package overview
236       r.li.daemon
237
238        Old r.le suite manual (1992)
239
240        wxGUI
241       wxGUI components
242

REFERENCES

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

AUTHOR

249       Luca Delucchi
250       Rewritten from r.li.setup by Claudio Porta and Lucio Davide Spano
251
252       $Date: 2016-01-28 12:21:34 +0100 (Thu, 28 Jan 2016) $
253

SOURCE CODE

255       Available at: wxGUI RLi Setup source code (history)
256
257       Main index | GUI index | Topics index  |  Keywords  index  |  Graphical
258       index | Full index
259
260       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
261
262
263
264GRASS 7.6.0                                                  wxGUI.rlisetup(1)
Impressum