# bugsigdbr <!-- badges: start --> [](https://lifecycle.r-lib.org/articles/stages.html#experimental) [](https://github.com/waldronlab/bugsigdbr/actions) [](https://codecov.io/gh/waldronlab/bugsigdbr?branch=main) <!-- badges: end --> Utilities for accessing data from [BugSigDB.org](https://bugsigdb.org) and creating plain text signatures. ## Installation instructions Get the latest stable `R` release from [CRAN](http://cran.r-project.org/). Then install `bugsigdbr` from [Bioconductor](https://bioconductor.org/packages/bugsigdbr/) using the following code: ``` r if (!requireNamespace("BiocManager", quietly = TRUE)) { install.packages("BiocManager") } BiocManager::install("bugsigdbr") ``` Or the development version from [GitHub](https://github.com/waldronlab/bugsigdbr) with: ``` r BiocManager::install("waldronlab/bugsigdbr") ``` ## Example ``` r library(bugsigdbr) bsdb <- bugsigdbr::importBugSigDB() ``` ## Citation Ludwig Geistlinger, Chloe Mirzayi, Fatima Zohra, Rimsha Azhar, Shaimaa Elsafoury, Clare Grieve, Jennifer Wokaty, Samuel David Gamboa-Tuz, Pratyay Sengupta, Isaac Hecht, Aarthi Ravikrishnan, Rafael S. Goncalves, Eric Franzosa, Karthik Raman, Vincent Carey, Jennifer B. Dowd, Heidi E. Jones, Sean Davis, Nicola Segata, Curtis Huttenhower, Levi Waldron (2023) BugSigDB captures patterns of differential abundance across a broad range of host-associated microbial signatures. *Nature Biotechnology*, doi: [10.1038/s41587-023-01872-y](https://doi.org/10.1038/s41587-023-01872-y). ## Useful links * [bugsigdb.org](https://bugsigdb.org): A Comprehensive Database of Published Microbial Signatures * [BugSigDB issue tracker](https://github.com/waldronlab/BugSigDB/issues): Report bugs or feature requests for bugsigdb.org * [BugSigDBExports](https://github.com/waldronlab/BugSigDBExports): Hourly data exports of bugsigdb.org * [Stable data releases](https://zenodo.org/records/6468009): Periodic manually-reviewed stable data releases on Zenodo * [bugsigdbr](https://bioconductor.org/packages/bugsigdbr/): R/Bioconductor access to published microbial signatures from BugSigDB * [Curation issues](https://github.com/waldronlab/BugSigDBcuration/issues): Report curation issues, requests studies to be added * [bugSigSimple](https://github.com/waldronlab/bugSigSimple): Simple analyses of BugSigDB data in R * [BugSigDBStats](https://github.com/waldronlab/BugSigDBStats): Statistics and trends of BugSigDB * [BugSigDBPaper](https://github.com/waldronlab/BugSigDBPaper): Reproduces analyses of the [Nature Biotechnology publication](https://www.nature.com/articles/s41587-023-01872-y) * [community-bioc Slack Team](https://slack.bioconductor.org/): Join #bugsigdb slack channel