The applications listed here are available for use in the Discovery Environment and are documented in: Discovery Environment Manual.

Discovery Environment Applications List

The box below searches only this space.
To search the entire iPlant wiki, enter your query in the box at the upper right.

 

 

 

 

 

Skip to end of metadata
Go to start of metadata

For an introduction to using the DE, see Using the Discovery Environment.

Please work through the tutorial and add your comments on the bottom of this page, or email comments to upendra@cyverse.org. Thank you.

Rationale and background

Currently, the edgeR app in the DE does not allow multifactorial pairwise comparison of RNA-Seq data for differential gene expression analysis. To provide this functionality, the edgeR (multifactorial pairwise comparisons) app has been added. Based on SARTools (R package dedicated to the differential analysis of RNA-Seq data), edgeR (multifactorial pairwise comparisons) allows multifactorial pairwise comparison of RNA-Seq data for differential gene expression analysis. It provides tools to generate descriptive and diagnostic graphs, to run the differential analysis with the edgeR package, and export the results into easily readable tab-delimited files. It also facilitates the generation of an HTML report that displays all the figures produced, explains the statistical methods, and gives the results of the differential analyses. 

The SARTools R package has been developed at PF2 - Institut Pasteur by M.-A. Dillies and H. Varet (hugo.varet@pasteur.fr). Please cite H. Varet, L. Brillet-Guéguen, J.-Y. Coppee and M.-A. Dillies, SARTools: A DESeq2- and EdgeR-Based R Pipeline for Comprehensive Differential Analysis of RNA-Seq Data, PLoS One, 2016, doi: http://dx.doi.org/10.1371/journal.pone.0157022 when using this tool for any analysis published."

Introduction and overview

While there are many tools that determine the differential expression for microarray data (such as limma), these tools assume a continuous expression response (in fluorescence intensity), whereas RNA-Seq, ChIP-Seq, SAGE, DGE, and proteomics data generate expression counts. The edgeR (empirical analysis of DGE in R) app compares expression counts from different experimental data sets and uses Fisher's Exact Test to identify differentially expressed gene products. The edgeR approach uses a negative binomial distribution and simplifies the estimation of over-dispersion by assuming that mean and variance are related, allowing applications to experiment with small numbers of replicates. At least one of the experimental conditions must have replicated. edgeR assumes a negative binomial distribution (which simplifies to a Poisson distribution when there is no variation) and uses Bayes' inference to correct for variation prior to using Fisher's Exact Test to identify differential expression.

Robinson, Mark D., Davis J. McCarthy, Gordon K. Smyth. Bioinformatics. 2010 Jan 1;26(1):139-40. "edgeR: a Bioconductor package for differential expression analysis of digital gene expression data." http://bioinformatics.oxfordjournals.org/content/26/1/139.long

Prerequisites

  1. A CyVerse account. (Register for a CyVerse account at https://user.cyverse.org/.)
  2. An up-to-date Java-enabled web browser. (Firefox recommended. If you wish to work with your own large datasets and upload them using iCommands, Chrome is not suitable due to its issues in utilizing 64-bit Java.)
  3. Input files:
    • Target file: The user has to supply a tab-delimited file which describes the experiment; i.e. one that contains the name of the biological condition associated with each sample. This file is called "target". This file has one row per sample and is composed of at least three columns with headers:

      • first column: unique names of the samples (short but informative as they will be displayed on all the figures); (Ex: "label")
      • second column: name of the count files; (Ex: "file")
      • third column: biological conditions; (Ex: "group)
      • optional columns: further information about the samples (day of library preparation for example). (Ex: "cond")

      Table 1: Target file for the test dataset (see below):

      labelfilegroupcond
      5_OP_1count3.txtOP5
      5_OP_2count3.txtOP5
      5_OP_3count3.txtOP5
      33_OP_1count3.txtOP33
      33_OP_2count3.txtOP33
      33_OP_3count3.txtOP33
      5_M_1count3.txtM5
      5_M_2count3.txtM5
      5_M_3count3.txtM5
      33_M_1count3.txtM33
      33_M_2count3.txtM33
      33_M_3count3.txtM33
      5_LL_1count3.txtLL5
      5_LL_2count3.txtLL5
      5_LL_3count3.txtLL5
      33_LL_1count3.txtLL33
      33_LL_2count3.txtLL33
      33_LL_3count3.txtLL33
    • Raw counts file or Raw counts folder: The edgeR statistical analysis assumes that reads have already been mapped and that counts per feature (gene or transcript) are available. There are two different ways to provide the option to the app.
      • A raw counts file that contains all the samples, each column corresponds to a sample with gene/transcript the same and a column first column which consists of the unique IDs of the features. (See an example of this type in Table 2). You can use Htseq-Count-Merge-0.6.1 to generate that kind of file.
      • A directory consisting of one count file per sample with two tabs delimited columns without the header. The first column is the unique IDs of the features and the second column has raw counts associated with these features (null or positive integers) (See an example of this type in Table 3). You can use HTSeq-count-0.6.1 to generate this type of directory.
  1. Table 2: Raw counts file for the test dataset (see below):

    Contig5_OP_15_OP_25_OP_333_OP_133_OP_233_OP_35_M_15_M_25_M_333_M_133_M_233_M_35_LL_15_LL_25_LL_333_LL_133_LL_233_LL_3
    oystercontig_1854101731194742446222947430123111
    oystercontig_216416562123028002191805
    oystercontig_328313221242041482312170413
    oystercontig_47224139223121000110003
    oystercontig_5021100001000100030
    oystercontig_6000300700200100200
    oystercontig_71273094613715311160602132452050123746
    oystercontig_815438657561911235666935038514712963492817375788126
    oystercontig_91100002034100331100121

    Table 3: An example of a counts file within the folder that has two tabs delimited columns without header (see below): 

    oystercontig_1301
    oystercontig_28
    oystercontig_370
    oystercontig_40
    oystercontig_50
    oystercontig_62
    oystercontig_7123
    oystercontig_8375
    oystercontig_90

    Note

    Icon

    The user should provide the same number of read files inside a directory corresponding to the number of rows in the large file. If the counts and the target files are not supplied in the required formats, the app will not work and you will not be able to run the analysis.

4. Parameters

    • Project name: name of the project (must be supplied by the user);

    • Author Name: author of the analysis (must be supplied by the user);

    • Reference biological condition: reference biological condition used to compute fold-changes (no default, must be one of the levels target file);

    • Counts-per-million cut-off: counts-per-million cut-off to filter low counts (Mandatory. default is 1, set to 0 to disable filtering);

    • Replicates: number of replicates (default is 2)

    • batch: adjustment variable to use as a batch effect, must be a column of the target file ("day" for example, orNULL if no batch effect needs to be taken into account);

    • Variable of Interest: variable of interest, i.e. biological condition, in the target file (Mandatory. "group" by default);

    • FeaturesToRemove: character vector containing the IDs of the features to remove before running the analysis (default is "alignment_not_unique"). Other available features are"ambiguous""no_feature""not_aligned""too_low_aQual" to remove HTSeq-count specific rows);

    • gene.selection: method of selection of the features for the MultiDimensional Scaling plot ("pairwise" by default or common);

    • Normalization Method: normalization method in calcNormFactors()"TMM" (default)  or "upperquartile";

    • Significance threshold: significance threshold applied to the adjusted p-values to select the differentially expressed features (default is 0.05);

    • p-value adjustment method: p-value adjustment method for multiple testing ("BH" by default, "BY" or any value of p.adjust.methods);

    • colors: colors used for the figures (one per biological condition)

    • Test/sample data

This tutorial uses the test data that is stored in the Data Store at Community Data > iplantcollaborative > example_data > edgeR_multi.          

Starting an edgeR (multifactorial pairwise comparisons) job in the DE

  1. In the DE Apps window, search for and open edgeR (multifactorial pairwise comparisons).
  2. In the Analysis Name field:
    1. Change the name for your analysis (optional).
    2. Enter any comments (optional).
    3. In the Select output folder field, click Browse and navigate to the folder of your choice, or leave the default name of iplant/home/username/analyses.
    4. To retain copies of the input files in your analysis results output folder, click the Retain Inputs checkbox.
  3. Click to open the Input files panel:
    1. For the Target file, click Browse and navigate to test either the file_type test data or the folder_type test data:
    • To test the file_type test data:
      1. For the Target file, browse to select target3.txt inside file_type.  
      2. For the Raw counts file, browse to select counts3.txt.
    • To test the folder_type test data:
      1. For the Target file, browse to select target3.txt inside file_type.
      2. For the Raw counts folder, browse to select raw1 inside folder_type.
  4. Click on the Parameters panel and enter the following:
    • Project name: test_edgeR_multi

    • Author Name: Upendra

    • Reference biological condition: OP

    • Counts-per-million cut-off: 1

    • Replicates: 3

    • batch: cond

    • Variable of Interest: group

    • FeaturesToRemovealignment_not_unique,ambiguous,no_feature,not_aligned,too_low_aQual

    • gene.selectionpairwise

    • Normalization Method: TMM

    • Significance threshold: 0.05

    • p-value adjustment method: BH

    • colorsdodgerblue,orange,green

     5.  Click Launch Analysis. 

     6. After successful completion of running of the app, the following files and figures are generated from the test run.

    • barplotTC.png: the total number of reads per sample;
    • barplotNull.png: percentage of null counts per sample;
    • densplot.png: estimation of the density of the counts for each sample;
    • majSeq.png: percentage of reads caught by the feature having the highest count in each sample;
    • pairwiseScatter.png: pairwise scatter plot between each pair of samples and SERE values (not produced if more than 30 samples);
    • countsBoxplot.png: boxplots on raw and normalized counts;
    • cluster.png: hierarchical clustering of the samples (CPM data);
    • MDS.png: Multi-Dimensional Scaling plot of the samples;
    • BCV.png: graph of the estimations of the tagwise, trended and common dispersions;
    • rawpHist.png: histogram of the raw p-values for each comparison;
    • MAplot.png: MA-plot for each comparison (log ratio of the means vs intensity);
    • volcanoPlot.png: volcano plot for each comparison ($-\log_{10}\text{(adjusted P value)}$ vs log ratio of the means).

       Some tab-delimited files are exported in the tables directory. They store information on the features as $\log_2\text{(FC)}$ or p-values and can be read easily in a spreadsheet:

    • TestVsRef.complete.txt: contains all the features studied;
    • TestVsRef.down.txt: contains only significant down-regulated features, i.e. less expressed in Test than in Ref;
    • TestVsRef.up.txt: contains only significant up-regulated features i.e. more expressed in Test than in Ref.

Icon

All these parameters will be saved and written at the end of the HTML report in order to keep track of what has been done.

For more information of how to interpret these figures, files, troubleshooting, and FAQs,  please refer SARTools vignette for the differential analysis of 2 or more conditions with DESeq2 or edgeR.

  • No labels