PathoGFAIR: Galaxy FAIR and Adaptable Workflows for Pathogen Detection, Tracking and Samples Comparison
Welcome to the GitHub repository for the Foodborne Pathogen Detection and Tracking Project under the fund of EOSC life industry call 2021. This project aims to provide a comprehensive solution for the identification and tracking of (foodborne) pathogens using metagenomic (Nanopore) sequencing data. The workflows are developed using Galaxy, an open-source platform for FAIR data analysis.
-
Workflows: The core of this project consists of a series of Galaxy-based workflows collectively known as PathoGFAIR. These workflows are designed to process Nanopore sequencing data, detect pathogens, and track their presence across samples. Workflows are available via the Galaxy Intergalactic Workflow Comission IWC
PathoGFAIR consists of 5 workflows that are created to be scalable to any other type of sequencing technique as well as agnostic such that it can detect all possible pathogens without specifying any pathogen species or giving any information about the input samples to the workflows. The 5 workflows are:
- Preprocessing: where the quality controlling, reads trimming for quality retaining, host sequences removal and other contaminating sequences removal take place
- Taxonomy Profiling: where taxonomy profiling takes place identifying and visualizing our samples' community abundances down to the subspecies level
- Gene-based Pathogen Identification: where we identify all possible pathogens by identifying all the Virulence factors (VFs) genes and their specific locations, we also identify Antimicrobial resistance genes (AMRs) within the same workflow.
- Allele-based Pathogen Identification: where we identify all the SNPs and variants and create the consensus sequences of all samples
- PathoGFAIR Samples Aggregation and Visualisation: where we visualize the outputs of the pathogens drawing a heatmap of all the found pathogenic genes for all samples, phylogenetic trees relating samples together per common pathogenic genes found, and bar charts for important tabular outputs of previous workflows, e.g. number of identified SNPs and variants per sample, number of removed host reads and mapping depth and coverage.
-
Training Material: To assist users in understanding and using the workflows, we have provided extensive training material. This includes tutorials, documentation, and guidelines available via the Galaxy Training Network GTN.
-
Notebooks: In this repository, you'll find Jupyter notebooks that utilize the output generated by the workflows. These notebooks are designed for reproducing paper-associated figures and allow users to produce similar extra figures other than the ones already included in workflow 2 and 5. The notebook is also designed to run on any Galaxy instance using Jupytool.
-
Galaxy Instance: You can run the workflows on any Galaxy instance. The workflows are openly available on two workflow registries; WorkflowHub and Dockstore. You can directly use PathoGFAIR on the three main Galaxy servers; European, American, and Australian, or install it on any other Galaxy server.
-
Data Preparation: Ensure your data is in the correct format and follows the specified guidelines. Please take a look at the training material for details on input requirements.
-
Workflow Execution: Import the PathoGFAIR workflows into your Galaxy instance and follow the step-by-step instructions provided in the associated training material to execute the workflows on your data.
Repository Contents
-
Jupter notebooks: The
bindirectory contains Jupyter notebooks for post-processing and visualization of workflow results. -
Workflows output datasets: The
datadirectory contains outputs of the workflows after running them on the paper-mentioned samples (BioProject PRJNA982679, BioProjects PRJNA942086 and PRJNA942088). The directory also includes the samples metadata. -
Jupter notebooks results: The
resultsdirectory contains results after running the Jupyter notebooks on the workflows output datasets. -
Publication figures: The
docs/figuresdirectory contains all figures mentioned in the paper. -
Publication tables: The
docs/tablesdirectory contains all tables mentioned in the paper.
The Galaxy history includes the output of running PathoGFAIR workflows on 46 samples, sampled and sequenced by Biolytix.
If you use or refer to this project in your research, please cite the associated paper: [PathoGFAIR: a series of FAIR and adaptable (meta)genomics workflows for (foodborne) pathogens detection and tracking].
Feel free to contribute, open issues, or provide feedback.