lsm_l_mutinf: MUTINF (landscape level)

View source: R/lsm_l_mutinf.R

lsm_l_mutinfR Documentation

MUTINF (landscape level)

Description

Mutual information \[I(y,x)\]

Usage

lsm_l_mutinf(landscape, neighbourhood = 4, ordered = TRUE, base = "log2")

Arguments

landscape

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

neighbourhood

The number of directions in which cell adjacencies are considered as neighbours: 4 (rook's case) or 8 (queen's case). The default is 4.

ordered

The type of pairs considered. Either ordered (TRUE) or unordered (FALSE). The default is TRUE.

base

The unit in which entropy is measured. The default is "log2", which compute entropy in "bits". "log" and "log10" can be also used.

Details

It disambiguates landscape pattern types characterize by the same value of an overall complexity (lsm_l_joinent).

Value

tibble

References

Nowosad J., TF Stepinski. 2019. Information theory as a consistent framework for quantification and classification of landscape patterns. https://doi.org/10.1007/s10980-019-00830-x

See Also

lsm_l_ent, lsm_l_condent, lsm_l_joinent, lsm_l_relmutinf

Examples

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


landscapemetrics documentation built on Sept. 12, 2024, 7:42 a.m.