BAT (version 2.1.1)

evenness: Phylogenetic/functional evenness of species or individuals.

Description

Regularity of distance and abundance between two species in a community.

Usage

evenness(
  comm,
  tree,
  distance,
  method = "expected",
  func = "camargo",
  abund = TRUE
)

Arguments

comm

A sites x species matrix, with either abundance or incidence data. If missing, the evenness using the full tree or distance matrix is calculated.

tree

An hclust or phylo object representing a phylogenetic or functional tree. One of tree or distance must be provided.

distance

A dist or matrix object representing the phylogenetic or functional distance between species.

method

Calculate dispersion using "expected" values (default) or values based on "contribution" of species to the tree.

func

Calculate dispersion using "Camargo" (default) or "Bulla" index.

abund

A boolean (T/F) indicating whether evenness should be calculated using abundance data.

Value

A vector of values per site (or a single value if no comm is given).

Details

Evenness is calculated based on the index of Camargo (1993) or Bulla (1994) using the values of both edge lengths in the tree and their abundance.

If no tree or distance is provided the result is the original index.

References

Bulla, L. (1994) An index of evenness and its associated diversity measure. Oikos, 70: 167-171.

Camargo, J.A. (1993) Must dominance increase with the number of subordinate species in competitive interactions? Journal of Theoretical Biology, 161: 537-542.

Examples

# NOT RUN {
comm <- matrix(c(1,2,0,0,0,1,1,0,0,0,0,2,2,0,0,1,1,1,1,100), nrow = 4, byrow = TRUE)
distance <- dist(c(1:5), method = "euclidean")
tree <- hclust(distance, method = "average")
evenness(comm)
evenness(tree = tree, func = "bulla")
evenness(comm, tree)
evenness(comm, tree, method = "contribution")
evenness(comm, tree, abund = FALSE)
# }