Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
g.gui.rlisetup(1)	    GRASS GIS User's Manual	     g.gui.rlisetup(1)

NAME
       g.gui.rlisetup  - Configuration tool for	r.li modules.

KEYWORDS
       general,	GUI, raster, landscape structure analysis

SYNOPSIS
       g.gui.rlisetup
       g.gui.rlisetup --help
       g.gui.rlisetup  [--help]	 [--verbose]  [--quiet]	 [--ui]

   Flags:
       --help
	   Print usage summary

       --verbose
	   Verbose module output

       --quiet
	   Quiet module	output

       --ui
	   Force launching GUI dialog

DESCRIPTION
       The g.gui.rlisetup is a wxGUI component which allows the	user to	create
       a configuration file for	the analytical r.li modules. For a general in-
       troduction, see the r.li	overview.
       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 creation of sampling area:

	   o   Whole map layer:	use entire area	selected above,

	   o   Regions:	select one to many subareas via	mouse,

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

	       o   Random nonoverlapping,

	       o   Systematic contiguous,

	       o   Systematic noncontiguous,

	       o   Stratified random,

	       o   Centered over sites (vector points).

	   o   Moving window: rectangular or circular with size

       Definition of region for	analysis:

	   o   Whole map layer:	entire map (current region),

	   o   Keyboard	setting: based on keyboard selection for region	 defi-
	       nition,

	   o   Draw  the sampling frame: based on interactive region selection
	       via mouse.

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

       TODO: description below needs further updates

       1      View/Edit	(Load a	file) from the shown list:  the	 configuration
	      is shown in a small text editor window.  Configuration files are
	      saved in the folder C:\Users\userxy\AppData\Roaming\GRASS7\r.li\
	      (MS-Windows)  or	$HOME/.r.li/ (GNU/Linux) (the file name	can be
	      defined by the user). The	output or an analysis can either be  a
	      new  raster map (in case of using	a "moving window" analysis) or
	      be an ASCII text file (when not  performing  a  "moving  window"
	      analysis)	 containing  the result.  Such text file will be saved
	      in the  folder  C:\Users\userxy\AppData\Roaming\GRASS7\r.li\out-
	      put\ (MS-Windows)	or $HOME/.grass7/r.li/output/ (GNU/Linux).
	      All dimensions are percentages of	raster rows or columns.

       2      Create a new configuration file: used for	creating a new config-
	      uration file in an interactive way, in three steps:

       2.1    Choose file name and maps	to use for setting:

	   o   Name for	new configuration file(required): the name of new con-
	       figuration file

	   o   Raster  map name	to use to select areas (required): the name of
	       raster map used for selecting sampling areas

	   o   Vector map to overlay (optional): name of a vector map used for
	       selecting sampling areas

       2.2    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:

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

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

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

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

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

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

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

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

		   o   Random  non  overlapping: the user specifies the	number
		       of sample units and they	are placed in a	random way  at
		       runtime.	 It is guaranteed that the areas do not	inter-
		       sect themselves.

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

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

		   o   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 ar-
		       eas are placed in a random way, one for every m*n areas
		       defined by strats.

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

	       o   mouse: the user chooses the shape and then draws the	speci-
		   fied	number of sample areas on map.

	   o   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 pro-
	       duces a new raster containing the result	of all analysis.

	   o   Select areas from the overlaid 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 they want to  in-
	       clude  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.

       Screenshots of the wizard window	frames:

       A  g.gui.rlisetup: First	frame of wizard	for  selecting	ex- A  g.gui.rlisetup: Frame for selecting maps
       isting configuration files or creating a	new one

       A  g.gui.rlisetup: Frame	for inserting sampling areas	    A	g.gui.rlisetup:	 Frame	for  defining rectangular moving
								    window

       A  g.gui.rlisetup: Frame	for defining circular moving window A  g.gui.rlisetup: Frame for  choosing  the	 sampling  frame
								    with keyboard

       A  g.gui.rlisetup: Frame	for drawing the	sampling frame	    A  g.gui.rlisetup: Summary frame before saving

EXAMPLES
   Moving window analysis on full region
       TODO: update examples to	new g.gui.rlisetup dialog:

       Example	for a 7x7 moving window	analysis on full region, the output is
       a raster	map:

       Click on	"New", then:

	   o   Configuration file name:	"movwindow7"

	   o   Raster map name to use to select	areas: "forests"
       1. Setup	sampling frame:

	   o   Define a	sampling  frame	 (region  for  analysis):  "Whole  map
	       layer", then "OK"
       2. Setup	sampling frame

	   o   Define sampling areas: "Moving window", then "OK"

	   o   Then click on "Use keyboard to define moving window dimension"
       Select type of shape:

	   o   [x] Rectangular

	   o   Width size (in cells)?: "7"

	   o   Height size (in cells)?:	"7"

	   o   Then "Save settings"
       3. Save settings: click on button
       (4.) Close

       Now  an	anaysis	 can be	performed using	one of the analytical modules,
       e.g.
       g.region	raster=forests -p
       r.li.patchdensity input=forests conf=movwindow7 output=forests_p_dens7
       r.univar	forests_p_dens7
       The result is the new raster map	"forests_p_dens7" which	shows (in this
       example)	the patch density of the forest	areas.
       See the respective modules for further examples.

   Whole region	analysis
       Example	for  a whole region analysis, the output is a text file: Click
       on "New", then:

	   o   Configuration file name:	"whole_region"

	   o   Raster map name to use to select	areas: "lsat7_2000_40"
       1. Setup	sampling frame:

	   o   Define a	sampling  frame	 (region  for  analysis):  "Whole  map
	       layer", then "OK"
       2. Setup	sampling frame

	   o   Define sampling areas: "Whole map layer", then "OK"
       3. Save settings: click on button
       (4.) Close

       Now  an	anaysis	 can be	performed using	one of the analytical modules,
       e.g.
       g.region	raster=lsat7_2002_40 -p
       r.li.shannon input=lsat7_2000_40	conf=whole_region output=lsat7_2000_40_shannon
       The result is the new text file	"forests_p_dens7"  (stored  in	folder
       $HOME/.r.li/output/.
       See the respective modules for further examples.

SEE ALSO
	r.li - package overview
       r.li.daemon

	Old r.le suite manual (1992)

	wxGUI
       wxGUI components

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

AUTHOR
       Luca Delucchi
       Rewritten from r.li.setup by Claudio Porta and Lucio Davide Spano

SOURCE CODE
       Available at: wxGUI RLi Setup source code (history)

       Main  index | GUI index | Topics	index |	Keywords index | Graphical in-
       dex | Full index

       A(C) 2003-2020 GRASS Development	Team, GRASS GIS	7.8.3 Reference	Manual

GRASS 7.8.3						     g.gui.rlisetup(1)

NAME | KEYWORDS | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLES | SEE ALSO | REFERENCES | AUTHOR | SOURCE CODE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=g.gui.rlisetup&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help