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

NAME

6       r.li.patchnum  - Calculates patch number index on a raster map, using a
7       4 neighbour algorithm.
8

KEYWORDS

10       raster, landscape structure analysis, patch index
11

SYNOPSIS

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

DESCRIPTION

45       r.li.patchnum calculates the "patch number index" as:
46        f(sample_area)= Patch_Number
47
48       This  index is calculated using a 4 neighbour algorithm, diagonal cells
49       are ignored when tracing a patch.
50

NOTES

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

EXAMPLES

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

SEE ALSO

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

REFERENCES

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

AUTHORS

95       Michael Shapiro - CERL (patch identification)
96       Markus Metz (statistics)
97

SOURCE CODE

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