r.li.shape(1grass)

1r.li.shape(1)                 Grass 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

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
100       Last changed: $Date: 2014-12-19 22:17:36 +0100 (Fri, 19 Dec 2014) $
101

SOURCE CODE

103       Available at: r.li.shape source code (history)
104
105       Main  index  | Raster index | Topics index | Keywords index | Graphical
106       index | Full index
107
108       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
109
110
111
112GRASS 7.6.0                                                      r.li.shape(1)