lsm_l_shei() R function from [landscapemetrics]

SHEI (landscape level)

Shannons's evenness index (Diversity metric)


lsm_l_shei(landscape)

Arguments

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

Returns

tibble

Details

SHEI = \frac{- \sum \limits_{i = 1} ^ {m} (P_{i} * \ln P_{i})} {\ln m}

where $P_{i}$ is the proportion of class i and $m$ is the number of classes.

SHEI is a 'Diversity metric'. It is the ratio between the actual Shannon's diversity index and and the theoretical maximum of the Shannon diversity index. It can be understood as a measure of dominance.

Units

None

Range

0 <= SHEI < 1

Behaviour

Equals SHEI = 0 when only one patch present and equals SHEI = 1 when the proportion of classes is completely equally distributed

Examples


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

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

Shannon, C., and W. Weaver. 1949. The mathematical theory of communication. Univ. IllinoisPress, Urbana

lsm_l_shei function