alpha: Global Ecosystem State Variables

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

View source: R/alpha.R

Description

Global indicators of the ecoystem state, including richness, evenness, diversity, and other indicators

Usage

1
alpha(x, index = "all", zeroes = TRUE)

Arguments

x

A species abundance vector, or matrix (taxa/features x samples) with the absolute count data (no relative abundances), or phyloseq-class object

index

Default is <e2><80><98>NULL<e2><80><99>, meaning that all available indices will be included. For specific options, see details.

zeroes

Include zero counts in the diversity estimation.

Details

This function returns various indices of the ecosystem state. The function is named alpha (global in some previous versions of this package) as these indices can be viewed as measures of alpha diversity. The function uses default choices for detection, prevalence and other parameters for simplicity and standardization. See the individual functions for more options. All indicators from the richness, diversity, evenness, dominance, and rarity functions are available. Some additional measures, such as Chao1 and ACE are available via estimate_richness function in the phyloseq package but not included here. The index names are given the prefix richness_, evenness_, diversity_, dominance_, or rarity_ in the output table to avoid confusion between similarly named but different indices (e.g. Simpson diversity and Simpson dominance). All parameters are set to their default. To experiment with different parameterizations, see the more specific index functions (richness, diversity, evenness, dominance, rarity).

Value

A data.frame of samples x alpha diversity indicators

Author(s)

Contact: Leo Lahti microbiome-admin@googlegroups.com

References

See citation('microbiome')

See Also

dominance, rarity, phyloseq::estimate_richness

Examples

1
2
3
data(dietswap)
d <- alpha(dietswap, index='shannon')
# d <- alpha(dietswap, index='all')

microbiome documentation built on Nov. 8, 2020, 5:08 p.m.