lsm_l_shdi: SHDI (landscape level)

Description

Shannon's diversity index (Diversity metric)

Usage

lsm_l_shdi(landscape)
# S3 method for RasterLayer
lsm_l_shdi(landscape)
# S3 method for RasterStack
lsm_l_shdi(landscape)
# S3 method for RasterBrick
lsm_l_shdi(landscape)
# S3 method for stars
lsm_l_shdi(landscape)
# S3 method for list
lsm_l_shdi(landscape)

Arguments

landscape

Raster* Layer, Stack, Brick or a list of rasterLayers.

Value

tibble

Details

$$SHDI = - \sum \limits_{i = 1}^{m} (P_{i} * \ln P_{i})$$ where $P_{i}$ is the proportion of class i.

SHDI is a 'Diversity metric'. It is a widely used metric in biodiversity and ecology and takes both the number of classes and the abundance of each class into account.

Units

None

Range

SHDI >= 0

Behaviour

Equals SHDI = 0 when only one patch is present and increases, without limit, as the number of classes increases while the proportions are equally distributed

References

McGarigal, K., SA Cushman, and E Ene. 2012. FRAGSTATS v4: Spatial Pattern Analysis Program for Categorical and Continuous Maps. Computer software program produced by the authors at the University of Massachusetts, Amherst. Available at the following web site: http://www.umass.edu/landeco/research/fragstats/fragstats.html

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

Examples

Run this code

# NOT RUN {
lsm_l_shdi(landscape)

# }

Run the code above in your browser using DataCamp Workspace