A Python tool to calculate penetrance tables for high-order epistasis models
A Python tool to calculate penetrance tables for high-order epistasis models.
Paper: González-Seoane, B., Ponte-Fernández, C., González-Domínguez, J. et al. PyToxo: a Python tool for calculating penetrance tables of high-order epistasis models. BMC Bioinformatics 23, 117 (2022). https://doi.org/10.1186/s12859-022-04645-7.
Mailing list: freelists.org/list/pytoxo. Join to start the discussion.
User manual (English version): manuals/manual_en.pdf.
User manual (Spanish version): manuals/manual_es.pdf.
PyToxo is a library for calculating penetrance tables of any bivariate epistasis model, developed in Python. It is a improved version of the Toxo library.
PyToxo is an easy-to-use tool, which can be used directly as a Python library, or through a command-line interface (CLI) or a graphical user interface (GUI). It is aimed at professionals or people interested in the field of bioinformatics and especially genetics.
This work is part of Borja González Seoane's final project for his Degree in Computer Engineering studies from the University of A Coruña.
PyToxo requires Python 3.8 or more modern to work. It is uploaded to the official Python PyPI repository, so it is only needed to run the following command to install it:
pip install pytoxo
- To see how PyToxo is used as a library, you can examine this example.
- To see how PyToxo is used through its CLI, you can examine this example. You can also revise the command-line help executing
- To see how PyToxo is used through its GUI, you can examine the PyToxo manual. However, the GUI is very intuitive and guides the user step by step. You might want to venture out using the
pytoxo_guicommand to open the interface and take a look on your own.
Run the tests
To run the tests you need to download this entire repository and install the development dependencies contained in manifest
pip install -r requirements_dev.txt
PyToxo project uses the Python
unittest to all its associated tests routines. PyToxo has unit, integration, solubility and accuracy level tests. All of them are stored into the
test directory and respect the format
To run the tests, the easiest way is using the helper scripts
test/run_all_tests_accuracy.py, to respectively run the appropriate tests. This script solve by their own the execution working directory, which must be the project home one.
It is also possible to run the tests since the command line. E.g.:
python -m unittest discover # Runs all python -m unittest discover test/unit # Runs unit tests python -m unittest discover test/integration # Runs integration tests # ...
The tests use material generated with Toxo to compare the two programs behaviour.
Thanks to María José Martín Santamaría and Christian Ponte Fernández for their supervision of the project. Also thanks to Jorge González Domínguez.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.