Description Usage Arguments Details Value Note Author(s) References See Also Examples

The function `eventstar`

finds the minimum (*q**) of the
evenness profile based on the Tsallis entropy. This scale factor
of the entropy represents a specific weighting of species
relative frequencies that leads to minimum evenness of the
community (Mendes et al. 2008).

1 | ```
eventstar(x, qmax = 5)
``` |

`x` |
A community matrix or a numeric vector. |

`qmax` |
Maximum scale parameter of the Tsallis entropy to be used in
finding the minimum of Tsallis based evenness
in the range |

The function `eventstar`

finds a characteristic value of the scale
parameter *q* of the Tsallis entropy corresponding to
minimum of the evenness (equitability) profile based on Tsallis entropy.
This value was proposed by Mendes et al. (2008) as *q**.

The *q** index represents the scale parameter of
the one parameter Tsallis diversity family that leads to
the greatest deviation from the maximum equitability given the relative
abundance vector of a community.

The value of *q** is found by identifying the minimum
of the evenness profile over scaling factor *q* by
one-dimensional minimization. Because evenness profile is
known to be a convex function, it is guaranteed that underlying
`optimize`

function will find a unique solution
if it is in the range `c(0, qmax)`

.

The scale parameter value *q** is used to
find corresponding values of diversity (*H.q**),
evenness (*H.q*(max)*),
and numbers equivalent (*D.q**). For calculation
details, see `tsallis`

and Examples below.

Mendes et al. (2008) advocated the use of *q**
and corresponding diversity, evenness, and Hill numbers, because
it is a unique value representing the diversity profile, and is
is positively associated with rare species in the community,
thus it is a potentially useful indicator of certain
relative abundance distributions of the communities.

A data frame with columns:

`qstar`

scale parameter value*q**corresponding to minimum value of Tsallis based evenness profile.`Estar`

Value of evenness based on normalized Tsallis entropy at*q**.`Hstar`

Value of Tsallis entropy at*q**.`Dstar`

Value of Tsallis entropy at*q**converted to numbers equivalents (also called as Hill numbers, effective number of species, ‘true’ diversity; cf. Jost 2007).

See `tsallis`

for calculation details.

Values for *q** found by Mendes et al. (2008) ranged
from 0.56 and 1.12 presenting low variability, so an
interval between 0 and 5 should safely encompass
the possibly expected *q** values in practice,
but profiling the evenness and changing the value of
the `qmax`

argument is advised if output values
near the range limits are found.

Eduardo Ribeiro Cunha edurcunha@gmail.com and Heloisa Beatriz Antoniazi Evangelista helobeatriz@gmail.com, with technical input of Péter Sólymos.

Mendes, R.S., Evangelista, L.R., Thomaz, S.M.,
Agostinho, A.A. and Gomes, L.C. (2008) A unified
index to measure ecological diversity and species
rarity. *Ecography* **31**, 450–456.

Jost, L. (2007) Partitioning diversity into independent alpha and beta components.
*Ecology* **88**, 2427–2439.

Tsallis, C. (1988) Possible generalization of Boltzmann-Gibbs statistics.
*J. Stat. Phis.* **52**, 479–487.

Tsallis entropy: `tsallis`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | ```
data(BCI)
(x <- eventstar(BCI[1:5,]))
## profiling
y <- as.numeric(BCI[10,])
(z <- eventstar(y))
q <- seq(0, 2, 0.05)
Eprof <- tsallis(y, scales=q, norm=TRUE)
Hprof <- tsallis(y, scales=q)
Dprof <- tsallis(y, scales=q, hill=TRUE)
opar <- par(mfrow=c(3,1))
plot(q, Eprof, type="l", main="Evenness")
abline(v=z$qstar, h=tsallis(y, scales=z$qstar, norm=TRUE), col=2)
plot(q, Hprof, type="l", main="Diversity")
abline(v=z$qstar, h=tsallis(y, scales=z$qstar), col=2)
plot(q, Dprof, type="l", main="Effective number of species")
abline(v=z$qstar, h=tsallis(y, scales=z$qstar, hill=TRUE), col=2)
par(opar)
``` |

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.