Skip to main content

pyComBat, a Python tool for batch effects correction in high-throughput molecular data using empirical Bayes methods

Project description


pyComBat [1] is a Python 3 implementation of ComBat [2], one of the most widely used tool for correcting technical biases, called batch effects, in microarray expression data.

More detailed documentation can be found at this address.


Minimum dependencies

We list here the versions of the packages that have been used for development/testing of pyComBat, as well as for writing the documentation.

pyComBat dependencies

  • python 3.6

  • numpy 1.16.4

  • mpmath 1.1.0

  • pandas 0.24.2

  • patsy 0.5.1


  • sphinx 2.1.2

Usage example


You can install pyComBat directly with:

pip install combat

You can upgrade pyComBat to its latest version with:

pip install combat --upgrade

Running pyComBat

The simplest way of using pyComBat is to first import it, and then simply use the pycombat function with default parameters:

from combat.pycombat import pycombat
data_corrected = pycombat(data,batch)
  • data: The expression matrix as a dataframe. It contains the information about the gene expression (rows) for each sample (columns).

  • batch: List of batch indexes. The batch list describes the batch for each sample. The list of batches contains as many elements as the number of columns in the expression matrix.

How to contribute

Please refer to to learn more about the contribution guidelines.


[1] Behdenna A, Haziza J, Azencot CA and Nordor A. (2020) pyComBat, a Python tool for batch effects correction in high-throughput molecular data using empirical Bayes methods. bioRxiv doi: 10.1101/2020.03.17.995431

[2] Johnson W E, et al. (2007) Adjusting batch effects in microarray expression data using empirical Bayes methods. Biostatistics, 8, 118–127

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for combat, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size combat-0.3.0-py3-none-any.whl (36.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size combat-0.3.0.tar.gz (11.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page