<!-- README.md is generated from README.Rmd. Please edit that file --> # `CBEA`: Taxonomic Enrichment Analysis in R <img src='man/figures/logo.png' align="right" height="100" style="float:right; height:110px;"/> <!-- badges: start --> [](https://codecov.io/gh/qpmnguyen/CBEA?branch=master) [](https://www.repostatus.org/#active) [](https://github.com/qpmnguyen/CBEA/actions) <!-- [](https://bioconductor.org/checkResults/release/bioc-LATEST/CBEA) --> <!-- badges: end --> ### Quang Nguyen The `CBEA` package provides basic functionality to perform taxonomic enrichment analysis in R. This package mainly supports the `CBEA` method, and provides additional support for generating sets for analyses using approaches commonly used in the gene set testing literature. ### Installation And the development version from [GitHub](https://github.com/) with: ``` r # install.packages("devtools") devtools::install_github("qpmnguyen/CBEA") ``` ### Features This package implements the CBEA approach for performing set-based enrichment analysis for microbiome relative abundance data. A preprint of the package can be found [on bioXriv](https://www.biorxiv.org/content/10.1101/2021.09.07.459294v1.full). In summary, CBEA (Competitive Balances for taxonomic Enrichment Analysis) provides an estimate of the activity of a set by transforming an input taxa-by-sample data matrix into a corresponding set-by-sample data matrix. The resulting output can be used for additional downstream analyses such as differential abundance, classification, clustering, etc. using set-based features instead of the original units. The transformation that CBEA applies is based on the isometric log ratio transformation that captures enrichment of a set as the balance between the geometric mean of variables in the set and remainder taxa. The inference procedure is performed through estimating the null distribution of the test statistic. This can be done either via permutations or a parametric fit of a distributional form on the permuted scores. Users can also adjust for variance inflation due to inter-taxa correlation. Please refer to the main manuscript for any additional details.