lsm_c_para_sd: PARA_SD (class level)

View source: R/lsm_c_para_sd.R

lsm_c_para_sdR Documentation

PARA_SD (class level)

Description

Standard deviation perimeter-area ratio (Shape metric)

Usage

lsm_c_para_sd(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_{SD} = sd(PARA[patch_{ij}]

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

PARA_SD is a 'Shape metric'. It summarises each class as the standard deviation 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_SD >= 0

Behaviour

Equals PARA_SD = 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, sd,
lsm_c_para_mn, lsm_c_para_cv,
lsm_l_para_mn, lsm_l_para_sd, lsm_l_para_cv

Examples

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


landscapemetrics documentation built on Oct. 3, 2023, 5:06 p.m.