calc_SPIE: Calculate S_PIE

View source: R/mobr_boxplots.R

calc_SPIER Documentation

Calculate S_PIE

Description

S_PIE is the effective number of species transformation of the probability of interspecific encounter (PIE) which is equal to the number of equally common species that result in that value of PIE.

Usage

calc_SPIE(x, PIE_replace = FALSE)

Arguments

x

can either be a: 1) mob_in object, 2) community matrix-like object in which rows represent plots and columns represent species, or 3) a vector which contains the abundance of each species.

PIE_replace

if TRUE, sampling with replacement is used. Otherwise, sampling without replacement (default).

Details

By default the sample size corrected version is returned (PIE_replace = FALSE), which is the asymptotic estimator for the Hill number of diversity order q=2 (Chao et al, 2014). If PIE_replace = TRUE the uncorrected hill number is returned. This is the same as vegan::diversity(x, index="invsimpson").

Value

either a single S_PIE value or vector of S_PIE values.

References

Chao, A., Gotelli, N. J., Hsieh, T. C., Sander, E. L., Ma, K. H., Colwell, R. K., & Ellison, A. M. (2014). Rarefaction and extrapolation with Hill numbers: A framework for sampling and estimation in species diversity studies. Ecological Monographs 84(1), 45-67.

See Also

calc_PIE

Examples

data(inv_comm)
calc_SPIE(inv_comm)
calc_SPIE(inv_comm, PIE_replace = TRUE)
calc_SPIE(c(23,21,12,5,1,2,3), PIE_replace=TRUE)

MoBiodiv/mobr documentation built on Nov. 5, 2024, 12:02 p.m.