Skip to content

tahiri-lab/aPhyloGeo

Repository files navigation



aPhyloGeo

License: MIT Contributions Py version Hits GitHub release build and test PyPI version

🌳 Multi-platform application for analyze phylogenetic trees with climatic parameters

Table of Contents
  1. About the project
  2. Installation
  3. Settings
  4. References
  5. Contact

📝 About the project

aPhyloGeo is a powerful and versatile bioinformatics pipeline specifically designed for the analysis of phylogeography. Developed by the dedicated team led by Professor Nadia Tahiri at the University of Sherbrooke in Quebec, Canada, this open-source multi-platform application is implemented in Python. It serves as a valuable tool for researchers and scientists interested in unraveling the intricate relationships between genetic sequences and geographic locations.

⚒️ Installation

Linux UNIX & Windows versions

aPhyloGeo is available as a Python script.

Prerequisites

This package use Poetry dependency management and packaging tool for Python. Poetry installation guide can be found here: Poetry Install ⚠️ For windows installation it's recommended to launch powershell in Administrator mode.

Once Poetry is installed, you can clone the repository and install the package using the following commands:

poetry install

Usage

Poetry will handle the virtual environment automatically. if you want to use the virtual environment manually, you can use the following command:

poetry shell

⚠️ Assuming Python 3.8 or higher is installed on the machine, these scripts should run well with the libraries installed.

You can also launch the package using the make command from your terminal when you are in the root. This command will use the Makefile to run the script. If you use the command make clean, it will erase the output.csv file previously created with the first command.

🚀 Settings

The aPhyloGeo software can be encapsulated in other applications and applied to other data by providing a YAML file. This file will include a set of parameters for easy handling (see Wiki documentation).

📚 Tutorials

We provide several tutorials to help you get started with the package.

📖 Documentation

You can also refer to the documentation for more details.

✔️ References

💡 If you are using our algorithm in your research, please cite our recent papers:

1️⃣ Li, W. & Tahiri, N. (2024). Host-Virus Cophylogeny Trajectories: Investigating Molecular Relationships between Coronaviruses and Bat Hosts. Preprint researchsquare

2️⃣ Li, W. & Tahiri, N. (2023). aPhyloGeo-Covid: A Web Interface for Reproducible Phylogeographic Analysis of SARS-CoV-2 Variation using Neo4j and Snakemake. Proceeding in SciPy 2023, Auxtin, TX, USA

3️⃣ Koshkarov, A., Li, W., Luu, M. L., & Tahiri, N. (2022). Phylogeography: Analysis of genetic and climatic data of SARS-CoV-2. Proceeding in SciPy 2022, Auxtin, TX, USA

📧 Contact

Please email us at: Nadia.Tahiri@USherbrooke.ca for any questions or feedback.