/PathoGFAIR

PathoGFAIR: Galaxy FAIR Workflows for Pathogen Detection and Samples Comparison

Primary LanguageJupyter NotebookMIT LicenseMIT

PathoGFAIR: Galaxy FAIR and Adaptable Workflows for Pathogen Detection, Tracking and Samples Comparison

Overview

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.

plot

How to find PathoGFAIR Workflows

Workflow Name WorkflowHub Dockstore Galaxy Servers
Nanopore Preprocessing (v 0.1) ID 1061 v 0.1 nanopore-pre-processing/main:v0.1 European Galaxy Server, United States Galaxy Server, Australian Galaxy Server
Taxonomy Profiling and Visualization with Krona (v 0.1) ID 1059 v 0.1 taxonomy-profiling-and-visualization-with-krona/main:v0.1 European Galaxy Server, United States Galaxy Server, Australian Galaxy Server
Gene-based Pathogen Identification (v 0.1) ID 1062 v 0.1 gene-based-pathogen-identification/main:v0.1 European Galaxy Server, United States Galaxy Server, Australian Galaxy Server
Allele-based Pathogen Identification (v 0.1) ID 1063 v 0.1 allele-based-pathogen-identification/main:v0.1 European Galaxy Server, United States Galaxy Server, Australian Galaxy Server
Pathogen Detection PathoGFAIR Samples Aggregation and Visualisation (v 0.1) ID 1060 v 0.1 pathogen-detection-pathogfair-samples-aggregation-and-visualisation/main:v0.1 European Galaxy Server, United States Galaxy Server, Australian Galaxy Server
PathoGFAIR 5in1 (v 0.1) Soon Soon European Galaxy Server, United States Galaxy Server, Australian Galaxy Server

Project Structure

  • 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.

How to Run the Workflows

  • 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 bin directory contains Jupyter notebooks for post-processing and visualization of workflow results.

  • Workflows output datasets: The data directory 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 results directory contains results after running the Jupyter notebooks on the workflows output datasets.

  • Publication figures: The docs/figures directory contains all figures mentioned in the paper.

  • Publication tables: The docs/tables directory contains all tables mentioned in the paper.

Galaxy History

The Galaxy history includes the output of running PathoGFAIR workflows on 46 samples, sampled and sequenced by Biolytix.

Contributors

Citation

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.