hillR: hill_taxa_parti – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

hill_taxa_parti

Decompostion of Taxonomic diversity through Hill Numbers

Description

Calculate taxonomic gamma, alpha, and beta diversity across all communities, as well as site similarity. If comm has 2 sites, this function gives pair comparison. If comm has >2 sites, gamma diversity is the diversity of the pooled assemblage, alpha is the average diversity across all site, beta is across all communities.

Usage

hill_taxa_parti(
  comm,
  q = 0,
  base = exp(1),
  rel_then_pool = TRUE,
  show_warning = TRUE,
  check_data = TRUE
)

Arguments

`comm`	A data frame of vegetation data. Sites as rows, species as columns.
`q`	Hill number, `q` = 0 (default) to get species richness, `q` = 1 to get shannon entropy, `q` = 2 will give inverse Simpson.
`base`	default is `exp(1)`, the base of log.
`rel_then_pool`	default is `TRUE.` Abundance of species are first changed to relative abundance within sites, then pooled into one assemblage. If `FALSE`, sites are pooled first, then change abundance of species to relative abundance.
`show_warning`	whether to print warning, default is `TRUE`.
`check_data`	whether to check data first? Default is `TRUE`.

Value

A data frame with one row (across all sites), including these columns: q, gamma diversity, alpha diverisity, beta diversity, MacArthur's homogeneity measure, local similarity (species overlap, similar to Sorensen), and region similarity (species overlap, similar to Jaccard). See Chao, Chiu and Jost 2014 Table 2 for more information.

References

Chao, Anne, Chun-Huo Chiu, and Lou Jost. Unifying Species Diversity, Phylogenetic Diversity, Functional Diversity, and Related Similarity and Differentiation Measures Through Hill Numbers. Annual Review of Ecology, Evolution, and Systematics 45, no. 1 (2014): 297–324. <doi:10.1146/annurev-ecolsys-120213-091540>.

Jost, Lou. Entropy and diversity. Oikos 113, no. 2 (2006): 363-375. <doi:10.1111/j.2006.0030-1299.14714.x>.

Examples

dummy = FD::dummy
hill_taxa_parti(comm = dummy$abun, q = 0)
hill_taxa_parti(comm = dummy$abun, q = 1)
hill_taxa_parti(comm = dummy$abun, q = 0.9999999)
hill_taxa_parti(comm = dummy$abun, q = 0.9999999, rel_then_pool = FALSE)
hill_taxa_parti(comm = dummy$abun, q = 1, rel_then_pool = FALSE)
hill_taxa_parti(comm = dummy$abun, q = 2)
hill_taxa_parti(comm = dummy$abun, q = 3)

hillR

Diversity Through Hill Numbers

v0.5.1

MIT + file LICENSE

Authors

Daijiang Li

Initial release

2021-03-01