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

NAME

6       r.li.padrange  - Calculates range of patch area size on a raster map
7

KEYWORDS

9       raster, landscape structure analysis, patch index
10

SYNOPSIS

12       r.li.padrange
13       r.li.padrange --help
14       r.li.padrange   input=name   config=name   output=name    [--overwrite]
15       [--help]  [--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.padrange calculates the range of patch area sizes in hectares as:
45       with:
46
47           ·   amax: max patch area size
48
49           ·   amin: min patch area size
50
51       This index is calculated using a 4 neighbour algorithm, diagonal  cells
52       are ignored when tracing a patch.
53

NOTES

55       Do  not  use  absolute  path  names  for the config and output file/map
56       parameters.   If  the  "moving   window"   method   was   selected   in
57       g.gui.rlisetup,  then  the  output  will  be a raster map, otherwise an
58       ASCII  file  will  be  generated  in  the  folder  C:\Users\userxy\App‐
59       Data\Roaming\GRASS7\r.li\output\             (MS-Windows)            or
60       $HOME/.grass7/r.li/output/ (GNU/Linux).
61
62       If the sample area contains only NULL values then r.li.padrange returns
63       NULL.
64

EXAMPLES

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

SEE ALSO

89        r.li - package overview
90       g.gui.rlisetup
91

REFERENCES

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

AUTHORS

98       Michael Shapiro - CERL (patch identification)
99       Markus Metz (statistics)
100

SOURCE CODE

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