coverage()
calculates an estimator of the sample coverage of a community
described by its abundance vector.
coverage_to_size()
estimates the sample size corresponding to the chosen
sample coverage.
coverage(x, ...)
# S3 method for class 'numeric'
coverage(
x,
estimator = c("ZhangHuang", "Chao", "Turing", "Good"),
level = NULL,
as_numeric = FALSE,
...,
check_arguments = TRUE
)
# S3 method for class 'abundances'
coverage(
x,
estimator = c("ZhangHuang", "Chao", "Turing", "Good"),
level = NULL,
...,
check_arguments = TRUE
)
coverage_to_size(x, ...)
# S3 method for class 'numeric'
coverage_to_size(
x,
sample_coverage,
estimator = c("ZhangHuang", "Chao", "Turing", "Good"),
as_numeric = FALSE,
...,
check_arguments = TRUE
)
# S3 method for class 'abundances'
coverage_to_size(
x,
sample_coverage,
estimator = c("ZhangHuang", "Chao", "Turing", "Good"),
...,
check_arguments = TRUE
)
An object.
Unused.
An estimator of the sample coverage.
"ZhangHuang" is the most accurate but does not allow choosing a level
.
"Good"'s estimator only allows interpolation, i.e. estimation of the coverage
of a subsample.
"Chao" allows estimation at any level
, including extrapolation.
"Turing" is the simplest estimator, equal to 1 minus the number of singletons
divided by the sample size.
The level of interpolation or extrapolation, i.e. an abundance.
If TRUE
, a number or a numeric vector is returned rather than a tibble.
If TRUE
, the function arguments are verified.
Should be set to FALSE
to save time when the arguments have been checked elsewhere.
The target sample coverage.
coverage()
returns a named number equal to the calculated sample coverage.
The name is that of the estimator used.
coverage_to_size()
returns a number equal to the sample size corresponding
to the chosen sample coverage.
The sample coverage \(C\) of a community is the total probability of occurrence 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 Good1953divent. It only relies on singletons (species observed only once). Chao's Chao2010adivent estimator uses doubletons too and Zhang-Huang's Chao1988,Zhang2007divent uses the whole distribution.
If level
is not NULL
, the sample coverage is interpolated or extrapolated.
Interpolation by the Good estimator relies on the equality between sampling
deficit and the generalized Simpson entropy Good1953divent.
The Chao2014;textualdivent estimator allows extrapolation,
reliable up a level equal to the double size of the sample.
coverage(paracou_6_abd)
#> # A tibble: 4 × 4
#> site weight estimator coverage
#> <chr> <dbl> <chr> <dbl>
#> 1 subplot_1 1.56 ZhangHuang 0.911
#> 2 subplot_2 1.56 ZhangHuang 0.893
#> 3 subplot_3 1.56 ZhangHuang 0.912
#> 4 subplot_4 1.56 ZhangHuang 0.902
coverage_to_size(paracou_6_abd, sample_coverage = 0.9)
#> # A tibble: 4 × 4
#> site weight sample_coverage size
#> <chr> <dbl> <dbl> <dbl>
#> 1 subplot_1 1.56 0.9 819
#> 2 subplot_2 1.56 0.9 940
#> 3 subplot_3 1.56 0.9 826
#> 4 subplot_4 1.56 0.9 778