divpro: Generate Hill diversity profile

In mikeroswell/MeanRarity: Hill Diversity Estimation and Visualization

Generate Hill diversity profile

Description

Compute observed Hill diversity profile based on an abundance vector over a range of scaling exponent values.

Usage

divpro(ab, ell_low = -1, ell_hi = 1, by = 0.001, use.q = FALSE)

Arguments

ab	A numeric vector of species abundances or relative abundances.
ell_low	Scalar, minimum scaling exponent for diversity profile.
ell_hi	Scalar, maximum scaling exponent for diversity profile.
by	Scalar, size of step along scaling exponent continuum.
use.q	Logical, use traditional q parameterization, where q= 1-l.

Details

Hill diversity can be viewed as a continuous function of the scaling exponent \ell and the relative abundance distribution. As \ell increases, so does the emphasis on rare species. It is traditional to view the profile across \ell = [-1, 1] or \ell = [-2, 1], and other authors have visualized this with low values of \ell at the right instead of left.

Value

Dataframe with the scaling exponent ell and corresponding Hill diversity d

Examples

divpro(c(20,8,5,4,2,1))
divpro(c(20,8,5,4,2,1), use.q =TRUE) # Option to use q = 1-ell for traditional
# Hill number parameterization

mikeroswell/MeanRarity documentation built on May 5, 2024, 4:50 p.m.