log_modulo_skewness {microbiome} | R Documentation

## Log-Modulo Skewness Rarity Index

### Description

Calculates the community rarity index by log-modulo skewness.

### Usage

    log_modulo_skewness(x, q = 0.5, n = 50)

### Arguments

`x` | Abundance matrix (taxa x samples) with counts
`q` | Arithmetic abundance classes are evenly cut up to to this quantile of the data. The assumption is that abundances higher than this are not common, and they are classified in their own group.
`n` | The number of arithmetic abundance classes from zero to the quantile cutoff indicated by q.

### Details

The rarity index characterizes the concentration of species at low abundance. Here, we use the skewness of the frequency distribution of arithmetic abundance classes (see Magurran & McGill 2011). These are typically right-skewed; to avoid taking log of occasional negative skews, we follow Locey & Lennon (2016) and use the log-modulo transformation that adds a value of one to each measure of skewness to allow logarithmization.

### Value

A vector of rarity indices

### Author(s)

Contact: Leo Lahti microbiome-admin@googlegroups.com

### References

Kenneth J. Locey and Jay T. Lennon. Scaling laws predict global microbial diversity. PNAS 2016 113 (21) 5970-5975; doi:10.1073/pnas.1521291113.

Magurran AE, McGill BJ, eds (2011) Biological Diversity: Frontiers in Measurement and Assessment (Oxford Univ Press, Oxford), Vol 12

### See Also

core_abundance, low_abundance, alpha

### Examples

    data(dietswap)
    d <- log_modulo_skewness(dietswap)

[Package microbiome version 1.12.0 Index]