FEAST - a scalable algorithm for quantifying the origins of complex microbial communities
A major challenge of analyzing the compositional structure of microbiome data is identifying its potential origins. Here, we introduce Fast Expectation-mAximization microbial Source Tracking (FEAST), a ready-to-use scalable framework that can simultaneously estimate the contribution of thousands of potential source environments in a timely manner, thereby helping unravel the origins of complex microbial communities. The information gained from FEAST may provide insight into quantifying contamination, tracking the formation of developing microbial communities, as well as distinguishing and characterizing bacteria-related health conditions. For more details see Shenhav et al. 2019, Nature Methods (https://www.nature.com/articles/s41592-019-0431-x).
For support using FEAST, please email: firstname.lastname@example.org
Software Requirements and dependencies
FEAST is written R. In addition to R 3.4.4 (and higher), it has the following dependencies::
"doParallel", "foreach", "dplyr", "vegan", "mgcv", "reshape2", "ggplot2", "philentropy", "MCMCpack", "lsei", "Rcpp", "RcppArmadillo" and "cowplot".
The input to FEAST is composed of two tab-separated ASCII text files :
count table - A matrix of samples by taxa with the sources and sink. The first row contains the sample headers (SampleID). The first column contains taxa ids. Then every consecutive column contains read counts for each sample. Note that this order must be respected (see example below).
metadata - The first row contains the headers (SampleID, Env, SourceSink). The first column contains sample ids. The second column is a description of the sampled environment (e.g., human gut), and the third column indicates if this sample is a source or a sink (can take the value 'Source' or 'Sink'). Note that these names must be respected (see example below).
The output is a vector of contributions of the known and unknown sources (with the pre-defined source environments as headers).
FEAST will be available on Qiime II in July 2019. Until then you can easily run it on your computer in just a few easy steps which I will walk you through in the following lines.
1. Clone this repository ('FEAST') and save it on your computer. 2. Save your input data (metadata and count table) in the directory 'Data_files'. 3. Run the file 'FEAST_main' from 'FEAST_src' after inserting the following arguments as input:
|path||The path in which you saved the repository 'FEAST' (e.g., "~/Dropbox/Microbial_source_Tracking")|
|metadata_file||The full name of you metadata file, including file type (e.g., "my_metadata.txt)|
|count_matrix||The full name of your taxa count matrix, including file type (e.g., "my_count_matrix.txt)|
|num_sources||Number of source environments in your data set|
|num_sources||1000||Number of EM iterations. We recommend using this default value.|
To run FEAST on example data (using one sink) do:
1. Clone this repository ('FEAST') and save it on your computer. 2. Run the file 'FEAST_example' which takes the following arguments as input: path = The path in which you saved the repository 'FEAST' (e.g., "~/Dropbox/Microbial_source_Tracking")
metadata (first 4 rows):
|ERR525698||infant gut 1||Sink|
|ERR525693||infant gut 2||Source|
|ERR525688||Adult gut 1||Source|
|ERR525699||Adult gut 2||Source|
count matrix (first 4 rows and columns):
|infant gut 2||Adult gut 1||Adult gut 2||Adult gut 3||Adult skin 1||Adult skin 2||Adult skin 3||Soil 1||Soil 2||unknown|
This is an exmaple illustrating the use of FEAST with one sink. To use FEAST with multiple sinks in parallel, please see 'FEAST_example_Multiple_sinks.R'
© 2018 Big Data and Genomics Lab at UCLA All Rights Reserved