Coverage: Sample coverage of a community

Description Usage Arguments Details Value Author(s) References Examples

View source: R/Coverage.R

Description

Calculates an estimator of the sample coverage of a community described by its abundance vector.

Usage

1
Coverage(Ns, Estimator = "ZhangHuang", CheckArguments = TRUE)

Arguments

Ns

A numeric vector containing species abundances.

Estimator

A string containing one of the possible estimators: "ZhangHuang" (default), "Chao", "Turing".

CheckArguments

Logical; if TRUE, the function arguments are verified. Should be set to FALSE to save time when the arguments have been checked elsewhere.

Details

The sample coverage C of a community is the total probability of occurence of the species observed in the sample. 1-C is the probability for an individual of the whole community to belong to a species that has not been sampled.

The historical estimator is due to Turing (Good, 1953). It only relies on singletons (species observed only once). Chao's (Chao and Shen, 2010) estimator uses doubletons too and Zhang-Huang's (Chao et al., 1988; Zhang and Huang, 2007) uses the whole distribution.

Value

A named number equal to the calculated sample coverage. The name is that of the estimator used.

Author(s)

Eric Marcon <Eric.Marcon@ecofog.gf>

References

Chao, A., Lee, S.-M. and Chen, T.-C. (1988). A generalized Good's nonparametric coverage estimator. Chinese Journal of Mathematics 16: 189-199.

Chao, A. and Shen, T.-J. (2010). Program SPADE: Species Prediction And Diversity Estimation. Program and user's guide. CARE, Hsin-Chu, Taiwan.

Good, I. J. (1953). On the Population Frequency of Species and the Estimation of Population Parameters. Biometrika 40(3/4): 237-264.

Zhang, Z. and Huang, H. (2007). Turing's formula revisited. Journal of Quantitative Linguistics 14(2-3): 222-241.

Examples

1
2
3
4
5
6
  # Load Paracou data (number of trees per species in two 1-ha plot of a tropical forest)
  data(Paracou618)
  # Ns is the vector of abundances of the metacommunity
  Ns <- Paracou618.MC$Ns
  # Calculate the sample coverage of the metacommunity
  Coverage(Ns)    # Stored in Paracou618.SampleCoverage

entropart documentation built on May 29, 2017, 11:47 a.m.

Search within the entropart package
Search all R packages, documentation and source code