lsm_c_iji: Interspersion and Juxtaposition index (class level)

View source: R/lsm_c_iji.R

lsm_c_ijiR Documentation

Interspersion and Juxtaposition index (class level)

Description

Interspersion and Juxtaposition index (Aggregation metric)

Usage

lsm_c_iji(landscape, verbose = TRUE)

Arguments

landscape

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

verbose

Print warning message if not sufficient patches are present

Details

IJI = \frac{- \sum \limits_{k = 1}^{m} \Bigg[ \Bigg( \frac{e_{ik}}{\sum \limits_{k = 1}^{m} e_{ik}} \Bigg) ln \Bigg( \frac{e_{ik}}{\sum \limits_{k = 1}^{m} e_{ik}} \Bigg) \Bigg]}{ln(m - 1)} * 100

where e_{ik} are the unique adjacencies of all classes (lower/upper triangle of the adjacency table - without the diagonal) and m is the number of classes.

IJI is an 'Aggregation metric'. It is a so called "salt and pepper" metric and describes the intermixing of classes (i.e. without considering like adjacencies - the diagonal of the adjacency table). The number of classes to calculate IJI must be >= than 3.

Units

Percent

Range

0 < IJI <= 100

Behaviour

Approaches 0 if a class is only adjacent to a single other class and equals 100 when a class is equally adjacent to all other classes.

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

McGarigal, K., & Marks, B. J. 1995. FRAGSTATS: spatial pattern analysis program for quantifying landscape structure. Gen. Tech. Rep. PNW-GTR-351. Portland, OR: US Department of Agriculture, Forest Service, Pacific Northwest Research Station. 122 p, 351.

See Also

lsm_l_iji

Examples

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

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