lsm_c_para_cv: PARA_CV (class level)

View source: R/lsm_c_para_cv.R

lsm_c_para_cvR Documentation

PARA_CV (class level)

Description

Coefficient of variation perimeter-area ratio (Shape metric)

Usage

lsm_c_para_cv(landscape, directions = 8)

Arguments

landscape

A categorical raster object: SpatRaster; Raster* Layer, Stack, Brick; stars or a list of SpatRasters.

directions

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

Details

PARA_{CV} = cv(PARA[patch_{ij}]

where PARA[patch_{ij}] is the perimeter area ratio of each patch.

PARA_CV is a 'Shape metric'. It summarises each class as the Coefficient of variation of each patch belonging to class i. The perimeter-area ratio describes the patch complexity in a straightforward way. However, because it is not standarised to a certain shape (e.g. a square), it is not scale independent, meaning that increasing the patch size while not changing the patch form will change the ratio.

Units

None

Range

PARA_CV >= 0

Behaviour

Equals PARA_CV = 0 if the perimeter-area ratio is identical for all patches. Increases, without limit, as the variation of the perimeter-area ratio increases.

Value

tibble

References

McGarigal K., SA Cushman, and E Ene. 2023. FRAGSTATS v4: Spatial Pattern Analysis Program for Categorical Maps. Computer software program produced by the authors; available at the following web site: https://www.fragstats.org

See Also

lsm_p_para,
lsm_c_para_mn, lsm_c_para_sd,
lsm_l_para_mn, lsm_l_para_sd, lsm_l_para_cv

Examples

landscape <- terra::rast(landscapemetrics::landscape)
lsm_c_para_cv(landscape)


landscapeecology/landscapemetrics documentation built on March 27, 2024, 10:13 a.m.