README.Rmd

---
output: github_document
---

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# BMix <img src='man/figures/logo.png' align="right" height="139" />

<!-- badges: start -->
[![R-CMD-check](https://github.com/caravagnalab/BMix/workflows/R-CMD-check/badge.svg)](https://github.com/caravagnalab/BMix/actions)
[![pkgdown](https://github.com/caravagnalab/BMix/actions/workflows/pkgdown.yaml/badge.svg)](https://github.com/caravagnalab/BMix/actions/workflows/pkgdown.yaml)
[![Lifecycle: maturing](https://img.shields.io/badge/lifecycle-stable-green.svg)](https://www.tidyverse.org/lifecycle/#stable)
<!-- badges: end -->

`BMix` provides univariate Binomial and Beta-Binomial mixture models. Count-based mixtures can be used in a variety of settings, for instance to model genome sequencing data of somatic mutations in cancer. `BMix` fits these mixtures by maximum likelihood exploiting the Expectation Maximization algorithm. Model selection for the number of mixture components is by the Integrated Classification Likelihood, an extension of the Bayesian Information Criterion that includes the entropy of the latent variables.

#### Citation

[![](https://img.shields.io/badge/doi-10.1038/s41588--020--0675--5-red.svg)](https://doi.org/10.1038/s41588-020-0675-5)

If you use `BMix`, please cite:

* G. Caravagna, T. Heide, M.J. Williams, L. Zapata, D. Nichol, K. Chkhaidze, W. Cross, G.D. Cresswell, B. Werner, A. Acar, L. Chesler, C.P. Barnes, G. Sanguinetti, T.A. Graham, A. Sottoriva. Subclonal reconstruction of tumors by using machine learning and population genetics. Nature Genetics 52, 898–907 (2020).



#### Help and support

[![](https://img.shields.io/badge/GitHub%20Pages-https://caravagnalab.github.io/BMix/-yellow.svg)](https://caravagnalab.github.io/BMix)

-----

#### Installation

You can install the released version of `BMix` from
[GitHub](https://github.com/) with:

``` r
# install.packages("devtools")
devtools::install_github("caravagnalab/BMix")
```

-----

#### Copyright and contacts

Giulio Caravagna. Cancer Data Science (CDS) Laboratory.

[![](https://img.shields.io/badge/CDS%20Lab%20Github-caravagnalab-seagreen.svg)](https://github.com/caravagnalab)
[![](https://img.shields.io/badge/CDS%20Lab%20webpage-https://www.caravagnalab.org/-red.svg)](https://www.caravagnalab.org/)