landscapemetrics (version 1.4.4)

lsm_c_lpi: LPI (class level)

Description

Largest patch index (Area and Edge metric)

Usage

lsm_c_lpi(landscape, directions)
# S3 method for RasterLayer
lsm_c_lpi(landscape, directions = 8)
# S3 method for RasterStack
lsm_c_lpi(landscape, directions = 8)
# S3 method for RasterBrick
lsm_c_lpi(landscape, directions = 8)
# S3 method for stars
lsm_c_lpi(landscape, directions = 8)
# S3 method for list
lsm_c_lpi(landscape, directions = 8)

Arguments

landscape

Raster* Layer, Stack, Brick or a list of rasterLayers.

directions

The number of directions in which patches should be connected: 4 (rook's case) or 8 (queen's case).

Value

tibble

Details

$$LPI = \frac{\max \limits_{j = 1}^{n} (a_{ij})} {A} * 100$$ where \(max(a_{ij})\) is the area of the patch in square meters and \(A\) is the total landscape area in square meters.

The largest patch index is an 'Area and edge metric'. It is the percentage of the landscape covered by the corresponding largest patch of each class i. It is a simple measure of dominance.

Units

Percentage

Range

0 < LPI <= 100

Behaviour

Approaches LPI = 0 when the largest patch is becoming small and equals LPI = 100 when only one patch is present

References

McGarigal, K., SA Cushman, and E Ene. 2012. FRAGSTATS v4: Spatial Pattern Analysis Program for Categorical and Continuous Maps. Computer software program produced by the authors at the University of Massachusetts, Amherst. Available at the following web site: http://www.umass.edu/landeco/research/fragstats/fragstats.html

See Also

lsm_p_area, lsm_l_ta, lsm_l_lpi

Examples

# NOT RUN {
lsm_c_lpi(landscape)

# }