Sovereign 8s.is mirror of standardgalactic/PyDESeq2
  • Python 99.8%
  • Shell 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Gregor Sturm 28cb793232
Some checks failed
pr-validation / run_tests (ubuntu-latest, 3.13) (push) Has been cancelled
pr-validation / run_tests (ubuntu-latest, --pre, 3.13) (push) Has been cancelled
pr-validation / run_tests (ubuntu-latest, 3.11) (push) Has been cancelled
pr-validation / run_tests (ubuntu-latest, 3.12) (push) Has been cancelled
Add credits section to README (#430)
* Add credits section to README

Added credits section acknowledging original developers and funding.

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-12-15 16:16:05 +01:00
.binder BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
.github BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
datasets BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
docs DOC update .readthedocs.yaml to handle installation through uv (#421) 2025-10-28 16:15:24 +01:00
examples MAIN fix issue 387 (#394) 2025-06-26 09:20:54 +02:00
pydeseq2 BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
tests BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
.coveragerc CI Basic code coverage (#74) 2023-02-13 11:17:40 +01:00
.gitignore BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
.pre-commit-config.yaml [pre-commit.ci] pre-commit autoupdate (#427) 2025-12-09 10:09:40 +01:00
.readthedocs.yaml DOC update .readthedocs.yaml to handle installation through uv (#421) 2025-10-28 16:15:24 +01:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2023-01-27 11:23:17 +01:00
CONTRIBUTING.md BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
LICENSE Initial commit 2022-11-22 18:14:12 +01:00
pyproject.toml BLD Build with uv, hatchling, updated CI/pre-commit and SPEC 0 compliant package versions (#416) 2025-10-20 17:08:50 +02:00
README.md Add credits section to README (#430) 2025-12-15 16:16:05 +01:00

pypi version pypiDownloads condaDownloads license

PyDESeq2 is a python implementation of the DESeq2 method [1] for differential expression analysis (DEA) with bulk RNA-seq data, originally in R. It aims to facilitate DEA experiments for python users.

As PyDESeq2 is a re-implementation of DESeq2 from scratch, you may experience some differences in terms of retrieved values or available features.

Currently, available features broadly correspond to the default settings of DESeq2 (v1.34.0) for single-factor and multi-factor analysis (with categorical or continuous factors) using Wald tests. We plan to implement more in the future. In case there is a feature you would particularly like to be implemented, feel free to open an issue.

Table of Contents

Installation

PyPI

PyDESeq2 can be installed from PyPI using pip:

pip install pydeseq2

We recommend installing within a conda environment:

conda create -n pydeseq2
conda activate pydeseq2
conda install pip
pip install pydeseq2

You can also add it to your projects through uv:

uv add pydeseq2

Bioconda

PyDESeq2 can also be installed from Bioconda with conda:

conda install -c bioconda pydeseq2

If you're interested in contributing or want access to the development version, please see the contributing section.

Requirements

The list of package version requirements is available in pyproject.toml.

For reference, the code is being tested in a github workflow (CI) with python 3.11 to 3.13 and the latest versions of the following packages:

- anndata
- formulaic
- numpy
- pandas
- scikit-learn
- scipy
- formulaic-contrasts
- matplotlib

Please don't hesitate to open an issue in case you encounter any issue due to possible deprecations.

Getting started

The Getting Started section of the documentation contains downloadable examples on how to use PyDESeq2.

Documentation

The documentation is hosted here on ReadTheDocs. If you want to have the latest version of the documentation, you can build it from source. Please go to the dedicated README.md for information on how to do so.

Data

The quick start examples use synthetic data, provided in this repo (see datasets.)

The experiments described in the PyDESeq2 article rely on data from The Cancer Genome Atlas, which may be obtained from this portal.

Contributing

Please the Contributing section of the documentation to see how you can contribute to PyDESeq2.

1 - Download the repository

git clone https://github.com/owkin/PyDESeq2.git

2 - Create a uv environment

Run uv venv --python 3.13 (or higher python version) to create the pydeseq2 environment and then activate it: source .venv/bin/activate.

cd to the root of the repo and run uv sync --extra dev --extra doc to install in developer mode.

Then, run pre-commit install.

The pre-commit tool will automatically run ruff, black, and mypy.

PyDESeq2 is a living project and any contributions are welcome! Feel free to open new PRs or issues.

Credits

PyDESeq2 has been originally developed by Boris Muzellec, Maria Teleńczuk, Vincent Cabeli, and Mathieu Andreux and funded by Owkin. In Dec 2025, the maintenance of PyDESeq2 was taken over by the scverse community.

Citing this work

@article{muzellec2023pydeseq2,
  title={PyDESeq2: a python package for bulk RNA-seq differential expression analysis},
  author={Muzellec, Boris and Telenczuk, Maria and Cabeli, Vincent and Andreux, Mathieu},
  year={2023},
  doi = {10.1093/bioinformatics/btad547},
  journal={Bioinformatics},
}

References

[1] Love, M. I., Huber, W., & Anders, S. (2014). "Moderated estimation of fold change and dispersion for RNA-seq data with DESeq2." Genome biology, 15(12), 1-21. https://genomebiology.biomedcentral.com/articles/10.1186/s13059-014-0550-8

[2] Zhu, A., Ibrahim, J. G., & Love, M. I. (2019). "Heavy-tailed prior distributions for sequence count data: removing the noise and preserving large differences." Bioinformatics, 35(12), 2084-2092. https://academic.oup.com/bioinformatics/article/35/12/2084/5159452

License

PyDESeq2 is released under an MIT license.