bioTEA 2.0.0

BioTEA, where Tea is short for Transcript Enrichment Analysis, is a pipeline for Differential Gene expression Analysis with microarray and RNA-seq data. It can download, preprocess and perform DEAs quickly, easily and in a reproducible way from the command line.

Check out the BioTEA Docker container, where the analysis code of BioTEA lives!

Read the publication:

Visentin, L.; Scarpellino, G.; Chinigò, G.; Munaron, L.; Ruffinatti, F.A. BioTEA: Containerized Methods of Analysis for Microarray-Based Transcriptomics Data. Biology 2022, 11, 1346.

Installation

IMPORTANT: BioTEA works on UNIX systems. To run on Windows, use the Windows Subsystems for Linux service.

1. Install Docker. The exact process is specific to your package manager:
   • For Ubuntu, follow this guide from the official Docker documentation.
   • For MacOS, follow this guide from the official Docker documentation.
   • For Arch Linux, install with:

     pacman -Syu docker
     systemctl enable --now docker.service
     

     You may need administrator privileges.
   • For other distros, check your distro package manager documentation.
2. Install Python version 3.12 or over. Again, this is dependent on your package manager:
   • On Ubuntu, run apt update && apt install python3.9. Depending on when you read this guide, you may need to tap into the deadsnakes PPA. Read the guides on the link I provided for more information. Just be sure that the result of python --version is 3.9 or higher when you continue to the following steps.
   • On Arch linux, run pacman -Syu python.
   • On MacOS, follow this guide in the python docs.
3. Optional but strongly recommended: Make a Python virtual environment to use bioTEA in. You can search online for a way to do this in your OS.
4. Install bioTEA with pip: pip install biotea.

IMPORTANT: Sometimes, critical bugs are fixed on the main branch but are yet to be released to PyPi. To get the development version of BioTEA, install it with pip install 'biotea @ git+https://github.com/CMA-Lab/bioTEA.git#subdirectory=src/bioTea'. If you run into problems, try and use this bleeding edge version, your issue might be fixed already!

If installed correctly, biotea info should give some information on the tool.

Usage

The publication provides an overview of the tool and its usage. It is a good place to start. For more information on the various commands, read the wiki.

If you run into problems using the BioTEA CLI, read the FAQ page on the wiki. If you still cannot solve the issue, file a bug report, detailing as much as you can your problem, including the versions of bioTEA, Python interpreter, Docker engine and your OS.

If you think that the issue is coming from the docker container (i.e. the Docker container is correctly launched but the analysis fails), you can create an issue in the bioTEA-box repository.

To change the logging level used by BioTEA, set the BIOTEA_LOG variable to the desired log level (e.g. "DEBUG", "WARNING", etc...). By default it is "INFO".

Contributing

To learn how you can contribute to the tool, read the CONTRIBUTING guide.

Version compatibility

The BioTEA cli generally gets more frequent updates than the BioTEA box. This causes their versions to drift apart. We stride to keep compatibility between the BioTEA cli and the box when the major versions are identical. This means that all BioTEA version x.y.z can run any BioTEA box of version x.*.*.