Skip to content

PessoaP/REPOP

Repository files navigation

REPOP - REconstruct POpulations from Plates

Overview

REPOP is a probabilistic modeling library designed to reconstruct bacterial population distributions from plate counting data. It provides efficient inference methods with built-in uncertainty quantification.

A more detailed explanation is available in our manuscript:
REPOP: A Tool for Bacterial Population Reconstruction with Uncertainty Quantification from Plate Counts
Available on eLife

REPOP is optimized for ease of use and computational efficiency. While it has minimal dependencies, it benefits significantly from GPU acceleration.

Installation & Dependencies

To install REPOP, simply clone the repository (or download the files, extract and put on folder) and run:

pip install .

REPOP requires only a few standard scientific computing libraries. These are installed automatically using the command above.

  • torch, numpy, matplotlib, scikit-learn

Usage

Running the Tutorial

To get started, check out the Jupyter notebook Tutorial.ipynb, which demonstrates how to use REPOP with plate counting data.

Generating Synthetic Data

To generate synthetic data used in the manuscript, navigate to the synth_data folder and run:

python cases.py

Citation

If you find our software or research helpful in your work, please consider citing our paper:

@article {Pessoa2025repop,
	author = {Pessoa, Pedro and Lu, Carol and Tashev, Stanimir Asenov and Kruithoff, Rory and Shepherd, Douglas P. and Press{\'e}, Steve},
	title = {REPOP: bacterial population quantification from plate counts},
	journal = {eLife},
	publisher = {eLife Sciences Publications, Ltd},
	year = {2025},
	doi = {10.7554/elife.107122.1}
}

Generating Graphs in the manuscript

The graphs for Fig. 1 are generated when running the tutorial. All others can be generated by the respective python script with its number in the file's name.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •