Skip to content

Latest commit

 

History

History
414 lines (250 loc) · 22.7 KB

IntegratedAssignment.md

File metadata and controls

414 lines (250 loc) · 22.7 KB
layout permalink title header1 header2 image home description
tutorial_page
/MIC_2021_IntA_lab
MIC 2021 Integrated Assignment
Workshop Pages for Students
Microbiome Analysis 2021
/site_images/CBW_Metagenome_icon.jpg
MIC 2021 Integrated Assignment

Developed by: Justin Jia & Muhammad Zohaib Anwar

Introduction

By now you’ve been introduced to a few pipelines for analyzing both 16S amplicon and shotgun metagenomics sequencing data. For this assignment we’ll be re-visiting these pipelines, but we will not be providing all of the commands for you to copy-and-paste. Two key skills for bioinformaticians to have is to be able to adapt existing pipelines on your data and to quickly learn how to use new tools. You’ll need to showcase both of these skills to complete this assignment!

For your integrated assignment, we will not provide a step-by-step tutorial. Rather you will use our knowledge gained from this workshop to explore a (sub-sampled) dataset collected from Shaiber. A et al by yourself.

Functional and genetic markers of niche partitioning among enigmatic members of the human oral microbiome - Genome Biology

By the end of this assignment, we hope that you will have a deep understanding of how each tool work, how everything ties together, and able to use these tools for your own research!

A quick introduction to this dataset

Microbiologists often studies the ecology of oral microbes in the Human Microbiome Project (HMP). They found extensive site specificity among oral microbes, making it a fascinating environment to study microbial colonization. The oral cavity is a rich environment with multiple distinct niches in a relatively small space partially due to its diverse anatomy, hard and soft tissue structures, and exposure to exogenous factors. Oral microbes form complex communities that show remarkable patterns of horizontal and vertical transmission across humans and animals. For details, please review the manuscript above.

Shaiber. A et al. sequenced amplicons (16S marker gene), shotgun metagenomics data and long read genomes. We will be using 8 samples from 16S rRNA dataset and shotgun metagenomes in this assignment. Table below gives an insight into selected samples.

Samples and files for Assignment

Samples OralSite Couple Gender SampleID 16S-SampleID_SRA_ID Shotgun-SRA_ID Co-assembled_Metagenomes
P-B-F Plaque B Female O_P_01, O_P_02, O_P_03, O_P_04, O_P_05 SRR11545396, SRR11545395, SRR11545397, SRR11545394, SRR11545398 SRR11562322, SRR11562321, SRR11562320, SRR11562319, SRR11562318 P-B-F.fa.gz
P-B-M Plaque B Male M_P_01, M_P_02, M_P_03, M_P_04, M_P_05 SRR11545393, SRR11545399, SRR11545392, SRR11545387, SRR11545388 SRR11562317, SRR11562316, SRR11562315, SRR11562314, SRR11562313 P-B-M.fa.gz
T-B-F Tongue B Female O_T_01, O_T_02, O_T_03, O_T_04, O_T_05 SRR11545361, SRR11545358, SRR11545362, SRR11545357, SRR11545363 SRR11562284, SRR11562283, SRR11562282, SRR11562281, SRR11562280 T-B-F.fa.gz
T-B-M Tongue B Male M_T_01, M_T_02, M_T_03, M_T_04, M_T_05 SRR11545355, SRR11545354, SRR11545353, SRR1154535, 2SRR11545348 SRR11562278, SRR11562277, SRR11562276, SRR11562275, SRR11562274 T-B-M.fa.gz
P-C-F Plaque C Female S_P_01, S_P_02, S_P_03, S_P_04 SRR11545389, SRR11545385, SRR11545390, SRR11545384 SRR11562311, SRR11562310, SRR11562309, SRR11562308 P-C-F.fa.gz
P-C-M Plaque C Male P_P_01, P_P_02, P_P_03, P_P_04, P_P_05, P_P_06 SRR11545391, SRR11545383, SRR11545382, SRR11545381, SRR11545380, SRR11545379 SRR11562307, SRR11562306, SRR11562305, SRR11562304, SRR11562303, SRR11562302 P-C-M.fa.gz
T-C-F Tongue C Female S_T_01, S_T_02, S_T_03, S_T_04, S_T_05 SRR11545347, SRR11545349, SRR11545346, SRR11545350, SRR11545345 SRR11562273, SRR11562272, SRR11562271, SRR11562270, SRR11562269 T-C-F.fa.gz
T-C-M Tongue C Male P_T_01, P_T_02, P_T_03, P_T_04, P_T_05, P_T_06 SRR11545344, SRR11545339, SRR11545340, SRR11545338, SRR11545341, SRR11545337 SRR11562267, SRR11562266, SRR11562265, SRR11562264, SRR11562263, SRR11562262 T-C-M.fa.gz

For shotgun metagenomics data, we have provided only 1 replicate from each sample in your instance due to limited computing and storage resources. However, if you would like to analyze complete dataset in your own computing resource, you can download all samples using the accession IDs provided in bold.

Data location and conda environment required

Before we begin, lets remind ourselves about a few important paths and conda activation command. Remeber to change into your working directory, make a new folder called "IntegratedAssignment" and cd into that. You can optionally symlink (ln) these data locations to your workspace as introduced in 16S module.

# Datasets

IntegratedAssignment=~/CourseData/MIC_data/IntegratedAssignment

# 16S rRNA reads
${IntegratedAssignment}/16s/16s_reads
# 16S Metadata txt
${IntegratedAssignment}/metadata.txt

# Shotgun Metagenomics
# Raw reads
${IntegratedAssignment}/ShotgunMetagenomics/metagenomic_reads

# Assembled Metagenomes
${IntegratedAssignment}/ShotgunMetagenomics/metagenomic_assemblies

# Pre-computed Metagenome Assembled Genomes (MAGs)
${IntegratedAssignment}/ShotgunMetagenomics/metagenome_assembled_genomes

# Pre-computed GTDB taxonomy assigned MAGs
${IntegratedAssignment}/ShotgunMetagenomics/GTDB_named_MAGs

# Pre-computed DRAM Annoted MAGs
${IntegratedAssignment}/ShotgunMetagenomics/DRAM_output_for_QC_MAGs/

# Activating conda environment
# Replace $env with the one you want to use
source activate $env
# OR
conda activate $env

We encourage you to (not immediately) refer back to the commands provided in the presented modules, but instead to read the help functions of each command (unless you’re stuck!), you can usually bring out the help menu by using the --help flag after your commands.

If you really do get stuck at a step and cannot figure it out by yourself, don't worry. Some intermediate files are available so that you can "skip" a command. Simply copy it from the following locations into your working directory and continue working. Make sure you come back at a later date to troubleshoot where it went wrong!

#Intermediate files

#16s Qiime2 related files
~/CourseData/MIC_data/16s/qiime2_Intermediate_Files

#16s PiCRUSt2 related files
~/CourseData/MIC_data/16s/picrust2_Intermediate_Files

Throughout this assignment, we will ask a few questions to keep you on track and reflect on what the outputs mean. For an added challenge, answer the questions posed in each module's practical using this oral microbiome dataset!

Last but not at least, feel free to work together here if it helps you, but please run the commands yourself in your own instance. Just note that the answers and results might be slighly different for different students depending on your parameters used.

PART I

1- 16S rRNA Gene Analyses

In this part of the integrated assignment, we will be analyzing a new 16S sequencing dataset of human oral microbiomes using what we learned in this workshop. We will be starting with FASTQ files and you will import them into Qiime2 and produce a tab-delimited file containing the ASV abundance data, assign taxonomy, measuring diversity, calculating differential abundances, and predicting the microbiome functional pathways. The same tools will be used, but the commands to use them will not all be provided! But no worries, there will be hints throughout the assignment to point you in the right direction. One part of the exercise is to use the correct commands and parameters, and the other is to read and understand the main output files.

1.1 - 16S raw data preprocessing and exploration

For this section, you will use the Qiime2 environment. Activate it with conda activate qiime2-2021.4.

Unlike the practical, you will start with the FASTQ reads for the integrated assignment. These FASTQs has been downloaded to your AWS instance already and can be found in the location specified above. Please symlink the files into your workspace directory. As with all sequencing data, a sequence quality pre-check and filtering step is crucial. For your first step, let's import these FASTQ files into a Qiime2 artefact and visualize our quality scores.

The import command is a bit different compared to the 16S module, see if you can figure it out by using the --help command or using the qiime2 import tutorial

If you have trouble, the answer is below after section 1.5.

After you do this, you should have a Qiime2 Artefact (.qza) and a Qiime2 visualization file (.qzv)

Hint commands:

ln
qiime tools import
qiime demux
The manifest file can be found in the 16s/16s_reads folder.
https://view.qiime2.com

Q1. How are the sequence qualities of this dataset? Are there any samples that have a low number of reads? Should the reads be truncated?

1.2- ASV identification and taxonomy classification

Now that you had checked your quality, let's identify ASVs and assign their respective taxa identities. If you determined that you need to truncate your reads due to quality issues, remember to do that now.

Hint commands:

qiime dada2 denoise-paired
qiime feature-classifier
The metadata file can be found in the 16s data folder (~/CourseData/MIC_data/IntegratedAssignment/16s/metadata.txt).
https://view.qiime2.com

Q2. What is the difference between ASVs and OTUs? Are there visual differences in taxa present at different oral sites? what about sex and couple?

1.3- Diversity metrics, phylogenetic trees and differential abundances.

With your ASV abundances, can you measure the diversity of our samples? Then, produce a phylogenetic tree of your microbiomes.

What you should have after this is a phylogenetic tree (.tre) and a few Qiime2 visualization artefacts containing your diversity measurements (.qzv)

Hint commands:

qiime diversity
qiime alignment
qiime phylogeny
qiime composition
https://view.qiime2.com

Q3. Can you describe any significant between group differences? Are there any site specific species?

1.4- Predicting the microbiome's functional pathways using PiCRUSt2

First, in order to predict the functional pathways, we need to extract a few files from our Qiime2 workflow.

Q4. Do you remember what the inputs for PiCRUSt2 are?

To generate the 3 input files from our Qiime2 work flow, check out the qiime tools export command. If you have trouble understanding it, see the answer below in section 1.6.

After you generated the input files, for the remainder of this section, you will use the picrust2 environment. Activate it with conda activate picrust2.

Now that we have the ASV abundance (abundances.tsv), ASV sequences (dna-sequences.fasta) and the metadata fille (metadata.txt), let's infer some functional pathways. We are now delving into the world of PiCRUSt2, refer back to the PiCRUSt2 tutorial for a refresher if needed. Let's start by generating our predictions for ECs.

Hint commands:

place_seqs.py
hsp.py
*remember to check for NSTI values.

With the 16S and ECs predicted, lets move onto the metagenome pipeline.

Hint commands:

metagenome_pipeline.py

Q5. What do each of the outputs of this pipeline mean? Which output would you use to determine taxa shifts between functions?

Last but not at least, pathway inference and adding descriptions.

Hint commands:

pathway_pipeline.py
add_descriptions.py

Q6. Now you have predicted the functional profile of your microbiomes, visualize it however you like and prepare a summary of differences in functional profiles between microbiomes of different oral sites. Can you describe the inherited limitations of using PiCRUSt2 to extrapolate microbiome functions?

1.5- Conclusion

Congratulations! You have just completed the 16s portion of the integrated assignment. I hope this gave you a chance to practice and solidify your understanding of 16S marker gene metagenomics.

Inside the ~/CourseData/MIC_data/IntegratedAssignment/16s folder, there is a file named section1_workflow.sh that contains all of the commands I used in section 1 to generate my results. Feel free to check your commands against it. Note that it might be different to what you did and that's totally okay!

Keep you findings and conclusions from the 16S data in mind though as we move on to delve into the shotgun metagenomic data of this oral microbiome in the next section. In the end, we will ask you to compare and contrast the findings of both methods.

###1.6- Code answers

For importing reads into Qiime2:

qiime tools import --type 'SampleData[PairedEndSequencesWithQuality]' --input-path ~/CourseData/MIC_data/IntegratedAssignment/16s/16s_reads/manifest.txt --output-path oralMicrobiome --input-format PairedEndFastqManifestPhred33V2

For exporting input files for picrust2

#export our ASV abundances
qiime tools export --input-path unfiltered_table.qza --output-path ./
biom convert -i feature-table.biom -o feature-table.tsv --to-tsv
#removing some junk rows in the tsv file.
tail -n +2 feature-table.tsv | tail -c +2 > abundances.tsv

#export the ASV's sequences
qiime tools export --input-path representative_sequences.qza --output-path ./



PART II

2- Shotgun Metegenomics

So far you have analyzed 16S part of the dataset from Shaiber. A et al. All of the samples we analyzed above were also sequenced using shotgun metagenomics sequencing as wll. The goal of this part II of assignment is to highlight that metagenomics provide a wider lens power to view same dataset. This assignment will expand on most parts from the Module 4 and 5 tutorials.

As you have learned during the workshop, there are more than one ways to analyze metagenomics data, for this assignment we will apply both pipelines introduced in the workshop.

  • Metagenomic reads based pipeline
  • Metagenomic assembly and binning pipeline

2.1- Metagenomic reads based pipeline

2.1.1- Filtering out human DNA (if attached) and contamination

Since these are human oral samples in Shaiber. A et al. it's always possible that there could be some host (human) DNA that was sequenced during shotgun metagenomics. Additionally, as learned in the tutorial, sometimes PhiX sequences (a common sequencing control) aren't properly removed from output files. We'll want to remove both these types of sequences before proceeding. Process of removing the host DNA is also called as dehosting.

Q. Dehost metagenomics sample provided at ~/CourseData/MIC_data/IntegratedAssignment/ShotgunMetagenomics/metagenomic_reads and prepare a summary of how many reads were dropped for each of the 6 samples?

Hint: kneaddata from Tutorial 4

Reminder: You can use GNU to run samples in parallel and --bypass-trim to skip trimming step

# Remember to activate conda environment
conda activate CBW_2021_KMER

2.1.2- Taxonomic profiling of short reads

In Part I (1.2) you have classified 16s rRNA ASVs using 16S based taxonomy database available. Now lets try to assign using Whole Genome Sequencing (WGS) based taxonomy database. Additionally, you will need to correct classification by estimating the species level abundance as discussed in Module 4 tutorial.

Q. Generate taxonomy profiles (classification + estimation of species level abundance) of the 6 samples that you have used in dehosting above. Do you see new taxa in metagenome based taxonomy as compared to 16S based taxonomy from Part I (1.2)? If yes, summarize if these are specie level differences/additions or wider taxa?

Hint: Kraken2 & Bracken from Tutorial 4 and use the helper script provided to concatenate forward and reverse reads before running the Kraken2.

perl helper_scripts/concat_paired_end.pl -p 4 --no_R_match -o cat_reads kneaddata_out/*_paired_*.fastq

# Remember to activate conda environment

# As per the Module4 Tutorial
# For kracken2
conda activate CBW_2021_KMER

# For bracken
conda activate CBW_2021_MARKER

2.1.3- Functional profiling from short reads

Now that we have the taxonomy profiles, we want to have the potential functional profiles for these samples for better resolution.

Q. Map the metagenomic short reads to UniRef90 (same database used in workshop) and summarize functional annotations across samples. Do you see unique (site-specific) functional profiles ? Are there any functional profiles that are different in both couples (B and C)?

Hint: MMseqs2 from Tutorial 4, you can also use Functional_Helper_Scripts/run_TaxonomyFunctionSearchMegan.pl to create job files for samples provided with Tutorial 4.

Reminder: As discussed in the workshop don’t forget to remove intermediate files to save significant storage space. This will help you perform following questions.

# Remember to activate conda environment

# As per the Module4 Tutorial
# For MMseqs2
conda activate CBW_2021_KMER

2.2- Metagenomic assembly and binning pipeline

This type of analyses is rather computationally intensive as compared to read based analysis. Some steps of this pipeline require significantly more CPU threads and RAM as compared to the instances available for current workshop. For this reason, we have pre-computed a few steps for you to be able to continue with next steps using the files. We have assembled metagenomes and binned Metagenome Assembled Genomes (MAGs). From these MAGs we have made 50 prominent MAGs available for further analysis. You can copy these files to your working directory and attempt to answer following questions.

2.2.1- Quality assesment and taxonomy classification of MAGs

Quality assessment of MAGs includes estimation of genome completeness and contamination by using collocated sets of genes that are ubiquitous and single-copy within a phylogenetic lineage. Assessment of genome quality can also be examined using plots depicting key genomic characteristics (e.g., GC, coding density) which highlight sequences outside the expected distributions of a typical genome.

Taxonomic classification of MAGs can be achieved by binning genomes into bins based on marker set compatibility, similarity in genomic characteristics, and proximity within a reference genome tree.

Quality assessment and taxonomic qualification are key for downstream analysis.

Q. Prepare a table or summary to answer following questions: Which MAGs have the highest quality in the dataset? How many MAGs pass a >70% complete & <10% contaminated threshold?

Hint: CheckM from Tutorial 5

Reminder: Don't forget to add --reduced_tree flag in CheckM, otherwise it may take significantly more time or even not possible to run CheckM

# Remember to activate conda environment

# As per the Module5 Tutorial
. "/usr/local/conda/etc/profile.d/conda.sh"
conda activate /usr/local/conda/envs/DRAM

2.2.2- Prevalence, abundance, and site-specificity of MAGs

Since the MAGs were pre-computed and provided without metadata, you will need to use some information about them for further analysis. You can use your knowledge of read mapping / read recruitment from Module 5 to find out the prevalence and abundance of these MAGs in different oral sites and couples.

Q2. Are there any site-specific (i-e tongue-associated, plaque-associates) genomes? If so, are these genomes' species found in 16S data? Prepare a table or figure to show the prevalence and abundance of MAGs across the couples and highlight site-specific (if any).

Hint: Bowtie2 & samtools from Tutorial 5

# This part was pre-computed in the tutorial5 but an example was added

# Remember to activate conda environment
# Bowtie2` & `samtools` are required for this which are available through this conda env
conda activate CBW_2021_MARKER

2.2.3- Phylogenomic analysis

From first two questions in this section, we have more information about the MAGs. Now we can get into downstream analysis.

Phylogenomics (inferring genome-level evolutionary relationships) is becoming a fundamental step in many biologists’ work—such as in the characterization of newly recovered genomes, or in leveraging available reference genomes to guide evolutionary questions. You have so far built phylogenegetic tree using 16S gene in first part of this assignment, now try another one using the MAGs.

Q. Build a phylogenomic tree using the MAGs, can you find common taxa in phylogenetic (16S assignment Q3) and phylogenomic trees? Do you see any new taxa compared to phylogenetic tree? Are any of the MAGs potentially duplicates of each other in the tree?

Hint: GtoTree from Tutorial 5

Reminder: For this question, we prefer for you to use MAGs that pass the QC metrics. We have already done that for you and assigned taxonomy using GTDB.

IntegratedAssignment=~/CourseData/MIC_data/IntegratedAssignment

# Pre-computed GTDB taxonomy assigned MAGs
${IntegratedAssignment}/ShotgunMetagenomics/GTDB_named_MAGs

# Remember to activate conda environment
conda activate /usr/local/conda/envs/DRAM

2.2.5- Functional annotation of MAGs

Finally, we would like you to functionally annotate QC filtered MAGs to identify different roles MAGs play within community. For functional annotation, you can use two different tool (DRAM, FeGenie). DRAM is computationally expensive and thus we have pre-computed the annotation process for you to visualize and summarize. Details of this are given below.

Q. Annotate MAGs using functional databases to identify what roles MAGs play in different oral sites? Do you see any unique functions/functional pathways in Couple B as compared to C?

Hint: FeGenie & DRAM from Tutorial 5

IntegratedAssignment=~/CourseData/MIC_data/IntegratedAssignment

# Pre-computed DRAM Annotated MAGs
${IntegratedAssignment}/ShotgunMetagenomics/DRAM_output_for_QC_MAGs/

# Remember to activate conda environment
conda activate /usr/local/conda/envs/DRAM

If you are reading this part, Congratulations you have completed the assignment !! Lets discuss your results in our upcoming session. If you are/were stuck on any part, write us on slack MIC channel. If its not possible to resolve, please summarize your error for discussion in upcoming session to discuss.


This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International. This means that you are able to copy, share and modify the work, as long as the result is distributed under the same license.