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   g.gui.rlisetup: Frame for selecting maps
157       existing 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

SEE ALSO

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

REFERENCES

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

AUTHOR

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

SOURCE CODE

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