Configurational entropy for landscape mosaics — bes_m

Calculates Cushman's configurational entropy for landscape mosaics (2015)

bes_m_cushman(x, nr_of_permutations, independent = FALSE)

Arguments

x: SpatRaster, stars, RasterLayer, RasterStack, RasterBrick, matrix, or array containing one or more categorical rasters
nr_of_permutations: Number of permutations performed on each input raster to calculate possible distribution of total edge values
independent: Should an independent set of permutations be performed for each input raster? TRUE/FALSE. Use FALSE (default) when each of your input rasters has the same configuration (proportion of categories).

Value

A tibble

References

Cushman, S. A. (2015). Calculating the configurational entropy of a landscape mosaic. In Landscape Ecology (Vol. 31, Issue 3, pp. 481–489). Springer Science and Business Media LLC. https://doi.org/10.1007/s10980-015-0305-2

Examples

library(terra)
library(bespatial)
mosaic = rast(system.file("raster/mosaic.tif", package = "bespatial"))
ce1 = bes_m_cushman(mosaic, 1000)
plot(mosaic, main = round(ce1$value, 2))

bes_m_cushman(mosaic, 1000, independent = TRUE)
#> # A tibble: 12 × 4
#>    layer type   metric    value
#>    <int> <chr>  <chr>     <dbl>
#>  1     1 mosaic cushman   -3.34
#>  2     1 mosaic cushman   -9.48
#>  3     1 mosaic cushman  -16.8 
#>  4     1 mosaic cushman  -26.0 
#>  5     1 mosaic cushman  -31.6 
#>  6     1 mosaic cushman  -37.4 
#>  7     1 mosaic cushman  -38.6 
#>  8     1 mosaic cushman  -51.6 
#>  9     1 mosaic cushman  -66.8 
#> 10     1 mosaic cushman  -95.7 
#> 11     1 mosaic cushman -105.  
#> 12     1 mosaic cushman -241.