Welcome to pylluminator

Pylluminator is a Python package designed to provide an efficient workflow for processing, analyzing and visualizing DNA methylation data, inspired from the popular R packages SeSAMe. and ChAMP.

It supports the following Illumina’s Infinium array versions :

human : 27k, 450k, MSA, EPIC, EPIC+, EPICv2
mouse : MM285
mammalian: Mammal40

Note

This project is under active development.

Main functionalities

idat files parsing
data preprocessing
- background correction
- normalization
- dye bias correction
- pOOBAH
- batch effect correction with ComBat
data analysis and visualisation
- beta values (density, PCA, MDS, dendrogram…)
- DMP and DMR, accounting for replicates / random effects
- CNV
quality control

Visualization examples:

Fig 1. Beta values	Fig 2. Differentially methylated regions (DMRs)
Fig 3. Gene visualization	Fig 4. Copy number variations (CNVs)

Installation

With pip

You can install Pylluminator directly with:

pip install pylluminator

From source

We recommend using a virtual environment with Python 3.12 to build pylluminator from source. Here is an example using Conda.

Setup the virtual environment (optional)

If you don’t have Conda installed yet, here are the instructions depending on your OS : Windows | Linux | MacOS. After installing it, make sure you have Pip installed by running the following command in the terminal:

conda install anaconda::pip

Now you can create a Conda environment named “pylluminator” and activate it. You can change the name to your liking ;)

conda create -n pylluminator python=3.12
conda activate pylluminator

Install pylluminator

You can download the latest source from github, or clone the repository with this command:

git clone https://github.com/eliopato/pylluminator.git

Your are now ready to install the dependencies and the package :

cd pylluminator
pip install .

Usage

Refer to https://pylluminator.readthedocs.io/ for step-by-step tutorials and detailed documentation.

Contributing

We welcome contributions! If you’d like to help improve the package, please follow these steps:

Fork the repository.
Create a new branch for your feature or bugfix.
Make your changes and test them.
Submit a pull request describing your changes.

Bug reports / new features suggestion

If you encounter any bugs, have questions, or feel like the package is missing a very important feature, please open an issue on the GitHub Issues page.

When opening an issue, please provide as much detail as possible, including:

Steps to reproduce the issue
The version of the package you are using
Any relevant code snippets or error messages

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

This package is strongly inspired from SeSAMe and includes code from methylprep for .idat files parsing.