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
54       parameters.    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\GRASS7\r.li\output\            (MS-Windows)             or
58       $HOME/.grass7/r.li/output/ (GNU/Linux).
59
60       If  the  input  raster  map  contains  only NULL values then r.li.shape
61       returns 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       Main  index  | Raster index | Topics index | Keywords index | Graphical
104       index | Full index
105
106       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
107
108
109
110GRASS 7.8.5                                                      r.li.shape(1)
Impressum