sheldon: Compute evenness using Sheldon's index

View source: R/sheldon.R

sheldonR Documentation

Compute evenness using Sheldon's index

Description

Sheldon's index is defined as S=\frac{e^H}{N}, where H is the Shannon diversity and N the species number. It ranges from 0 to 1, where 1 signifies a perfectly even abundance distribution.

Usage

sheldon(x, correction = TRUE, N2N1 = FALSE)

Arguments

x

a vector of species abundances

correction

whether or not to apply the correction described in Alatalo, Oikos 37, 199-204, 1981

N2N1

whether to compute Sheldon's evenness as the ratio of e raised to the power of H (H = Shannon diversity) and Simpson's diversity

Details

Note that the N2N1 mode results in evenness smaller than 1 for equal taxon probabilities.

Value

Sheldon's evenness

References

A.L. Sheldon 1969. Equitability indices: dependence on the species count. Ecology, 50, 466-467.

C Heip 1974. A new index measuring evenness. J. mar. biol. Ass. UK 54, 555-557.

Examples

N=50
# uneven species abundance distribution
v = round(generateAbundances(N, mode=5))
sheldon(v)
# perfectly even species abundance distribution
sheldon(rep(N,N))
# very uneven species abundance distribution
sheldon(c(rep(1,N),1000))

hallucigenia-sparsa/seqtime documentation built on Jan. 9, 2023, 11:53 p.m.