A Species Distribution is a (preferably named) vector containing species abundances or probabilities.
SpeciesDistribution
objects include AbdVector and ProbaVector objects.
# S3 method for wmppp
as.SpeciesDistribution(x, ...)
# S3 method for factor
as.SpeciesDistribution(x, ...)
# S3 method for character
as.SpeciesDistribution(x, ...)
# S3 method for wmppp
as.ProbaVector(x, ...)
# S3 method for factor
as.ProbaVector(x, ...)
# S3 method for character
as.ProbaVector(x, ...)
# S3 method for wmppp
as.AbdVector(x, ...)
# S3 method for factor
as.AbdVector(x, ...)
# S3 method for character
as.AbdVector(x, ...)
A wmppp.object with PointType
values as species names, or a vector of factors or characters containing species names of each individual.
Further arguments. Unsused.
A vector of species abundances (AbdVector) or probabilities (ProbaVector).
as.AbdVector
counts the number of individuals (points) per species (in marks$PointType
).
as.ProbaVector
normalizes the vector so that it sums to 1. If Correction
is not "None"
, the observed abundance distribution is used to estimate the actual species distribution. The list of species will be changed: zero-abundance species will be cleared, and some unobserved species will be added. First, observed species probabilities are estimated folllowing Chao and Shen (2003)
, i.e. input probabilities are multiplied by the sample coverage, or according to more sophisticated models: Chao et al. (2013)
, single-parameter model or Chao and Jost (2015)
, two-parameter model. The total probability of observed species equals the sample coverage. Then, the distribution of unobserved species can be unveiled: their number is estimated according to RCorrection
(if the Jackknife estimator is chosen, the JackOver
argument allows using the order immediately over the optimal one). The coverage deficit (1 minus the sample coverage) is shared by the unobserved species equally: Unveiling = "unif"
, Chao et al. (2013)
or according to a geometric distribution: Unveiling = "geom"
, Chao and Jost (2015)
.
SpeciesDistribution
objects can be plotted. The plot
method returns the estimated parameters of the fitted distribution. The broken stick has no parameter, so the maximum abundance is returned.
Chao A, Jost L (2015).
“Estimating Diversity and Entropy Profiles via Discovery Rates of New Species.”
Methods in Ecology and Evolution, 6(8), 873--882.
doi:10.1111/2041-210X.12349
.
Chao A, Shen T (2003).
“Nonparametric Estimation of Shannon's Index of Diversity When There Are Unseen Species in Sample.”
Environmental and Ecological Statistics, 10(4), 429--443.
doi:10.1023/A:1026096204727
.
Chao A, Wang Y, Jost L (2013).
“Entropy and the Species Accumulation Curve: A Novel Entropy Estimator via Discovery Rates of New Species.”
Methods in Ecology and Evolution, 4(11), 1091--1100.
doi:10.1111/2041-210x.12108
.