1r.li.shape(1)               GRASS GIS User's Manual              r.li.shape(1)
2
3
4

NAME

6       r.li.shape  - Calculates shape index on a raster map
7

KEYWORDS

9       raster, landscape structure analysis, patch index
10

SYNOPSIS

12       r.li.shape
13       r.li.shape --help
14       r.li.shape  input=name config=name output=name  [--overwrite]  [--help]
15       [--verbose]  [--quiet]  [--ui]
16
17   Flags:
18       --overwrite
19           Allow output files to overwrite existing files
20
21       --help
22           Print usage summary
23
24       --verbose
25           Verbose module output
26
27       --quiet
28           Quiet module output
29
30       --ui
31           Force launching GUI dialog
32
33   Parameters:
34       input=name [required]
35           Name of input raster map
36
37       config=name [required]
38           Configuration file
39
40       output=name [required]
41           Name for output raster map
42

DESCRIPTION

44       r.li.shape calculates the landscape shape index as:
45       LSI = 0.25 * E / sqrt(A)
46       with:
47
48           •   E: sum of all edges
49
50           •   A: sum of all patch areas
51

NOTES

53       Do not use absolute path names for the config and output  file/map  pa‐
54       rameters.    If   the   "moving   window"   method   was   selected  in
55       g.gui.rlisetup, then the output will be  a  raster  map,  otherwise  an
56       ASCII  file  will  be  generated  in  the  folder  C:\Users\userxy\App‐
57       Data\Roaming\GRASS8\r.li\output\            (MS-Windows)             or
58       $HOME/.grass8/r.li/output/ (GNU/Linux).
59
60       If  the  input raster map contains only NULL values then r.li.shape re‐
61       turns NULL.
62

EXAMPLES

64       To calculate the shape index on map my_map, using my_conf configuration
65       file  (previously  defined  with  g.gui.rlisetup) and saving results in
66       my_out, run:
67       r.li.shape input=my_map conf=my_conf output=my_out
68
69       Forest map (Spearfish sample dataset) example:
70       g.region raster=landcover.30m -p
71       r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
72       r.li.shape input=forests conf=movwindow7 out=forests_shape_mov7
73       r.univar forests_shape_mov7
74
75       Forest map (North Carolina sample dataset) example:
76       g.region raster=landclass96 -p
77       r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
78       r.li.shape input=forests conf=movwindow7 out=forests_shape_mov7
79       # verify
80       r.univar forests_shape_mov7
81       r.to.vect input=forests output=forests type=area
82       d.mon wx0
83       d.rast forests_shape_mov7
84       d.vect forests type=boundary
85

SEE ALSO

87        r.li - package overview
88       g.gui.rlisetup
89

REFERENCES

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

AUTHORS

96       Claudio Porta and Lucio Davide Spano, students of Computer Science Uni‐
97       versity of Pisa (Italy).
98       Commission from Faunalia Pontedera (PI) (www.faunalia.it)
99

SOURCE CODE

101       Available at: r.li.shape source code (history)
102
103       Accessed: Saturday Jan 21 21:14:58 2023
104
105       Main  index  | Raster index | Topics index | Keywords index | Graphical
106       index | Full index
107
108       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
109
110
111
112GRASS 8.2.1                                                      r.li.shape(1)