Difference between revisions of "MatrixREDUCE"

(Parameters)
 
Line 37: Line 37:
 
'''Save run log''' - diagnostic messages from the run will be saved to a file.
 
'''Save run log''' - diagnostic messages from the run will be saved to a file.
  
 +
 +
==Note on Activating Marker Sets==
 +
The local version of MatrixREDUCE ignores activated marker sets entirely.  In the "grid" version, activating a marker set affects the result shown in the PSAM Detail tab, but not in the sequence tab.
 +
 +
The user is advised not to activate marker sets during MatrixREDUCE runs.
  
 
==Services (Grid)==
 
==Services (Grid)==

Latest revision as of 12:26, 12 May 2014

Home | Quick Start | Basics | Menu Bar | Preferences | Component Configuration Manager | Workspace | Information Panel | Local Data Files | File Formats | caArray | Array Sets | Marker Sets | Microarray Dataset Viewers | Filtering | Normalization | Tutorial Data | geWorkbench-web Tutorials

Analysis Framework | ANOVA | ARACNe | BLAST | Cellular Networks KnowledgeBase | CeRNA/Hermes Query | Classification (KNN, WV) | Color Mosaic | Consensus Clustering | Cytoscape | Cupid | DeMAND | Expression Value Distribution | Fold-Change | Gene Ontology Term Analysis | Gene Ontology Viewer | GenomeSpace | genSpace | Grid Services | GSEA | Hierarchical Clustering | IDEA | Jmol | K-Means Clustering | LINCS Query | Marker Annotations | MarkUs | Master Regulator Analysis | (MRA-FET Method) | (MRA-MARINa Method) | MatrixREDUCE | MINDy | Pattern Discovery | PCA | Promoter Analysis | Pudge | SAM | Sequence Retriever | SkyBase | SkyLine | SOM | SVM | T-Test | Viper Analysis | Volcano Plot




Outline

This tutorial contains

  1. an overview of MatrixREDUCE,
  2. descriptions of data types, parameters, and the graphical user interface, and
  3. an example of a simple run of the program.

Overview

MatrixREDUCE is a tool for inferring the binding specificity and nuclear concentration of transcription factors from microarray data. The sequence specificity of the transcription factors' DNA-binding domain is modeled using a position-specific affinity matrix (PSAM), whose elements represent the change in the binding affinity whenever a specific position within a reference binding sequence is mutated. The PSAM(s) resulting from the fit to the microarray data can be displayed as an affinity logo or as a consensus sequence.

MatrixREDUCE was developed by Harmen Bussemaker at Columbia University. For further details see MatrixREDUCE.

Data Files

MatrixREDUCE operates on two data files plus an optional topological pattern file.

The data files required are a microarray gene expression dataset and a FASTA file containing the DNA sequences corresponding to the regulatory region of genes probed in the microarray experiment. The gene/probe identifiers used in the microarray dataset and the sequence identifiers used in the FASTA file must match. However, case is not important; the program will change the identifiers to lower case before attempting to match the records. If an identifier appears more than once in a file, the last instance is used.

The topological pattern can either be specified by name or loaded from an external file (via the adjacent "Load" button).

Parameters

(default values are shown in parentheses)

Topological Pattern - a flexible way to specify which motif patterns to search for; e.g. X6 for all hexamers, X3N5X3 for all dyads of trimers with a 5-bp spacer

P value - maximum p-value to accept a new motif (0.001).

Max Motif - Maximum # of motifs to search.

Strand - [("Auto-detect"), "Leading", "Reverse", "Both"]

Save run log - diagnostic messages from the run will be saved to a file.


Note on Activating Marker Sets

The local version of MatrixREDUCE ignores activated marker sets entirely. In the "grid" version, activating a marker set affects the result shown in the PSAM Detail tab, but not in the sequence tab.

The user is advised not to activate marker sets during MatrixREDUCE runs.

Services (Grid)

MatrixREDUCE can be run either locally within geWorkbench, or remotely as a grid job on caGrid. See the Grid Services section for further details on setting up a grid job.

Graphical Interface for results

PSAM Detail Tab

The PSAM detail tab displays the result PSAMs in a table format. Users can modify the display so that each PSAM is represented either by its sequence logo or its consensus sequence. Selected or all PSAMs can be exported to a text file using the "ExportAll" or "Export Selected" buttons.

Table Columns:

Select - If the box is checked, and the Export Selected button is pushed, the selected PSAMs will be exported to a file.

Consensus Sequence - This displays the PSAM resulting from the analysis as an affinity logo. The logo displays "the actual relative free energies of binding for each nucleotide at each position". The horizontal line indicates the average delta-delta-G at each position, each letter is placed above or below the line depending on whether its delta-delta-G is more or less favorable than the average. "The height of the letter can be interpreted as free energy difference from the average in units of RT." The tallest letters thus contribute most to the sequence specificity of the motif.


Experiment Name - the experiment used to fit the PSAM parameters, which had the strongest (absolute) correlation with the seed motif.

Seed sequence - the motif used as the seed for the PSAM fit.

F - regression coefficient resulting from the model fit. See eq 12, pg. e143 of Foat et al. 2006 link to paper.

t - t-value, equal to the regression coefficient divided by standard error.

P - P-value corresponding to the significance of the t-value.

Sequence Tab

The sequence tab displays the DNA sequences of the regulatory region associated with each gene that is probed. Users can visualize the matching scores of PSAMs against each sequence. Sequence score is the product of weights w across all positions in the sliding window.

When a PSAM is selected, its weighted score is displayed graphically on the input (upstream) sequences (Affinity score graph). The system computes for every position an aggregate affinity score for all selected PSAMs and plots the scores along all sequence positions. Each score is between 0 and 1. Only scores larger than the designated cut-off threshold are drawn.

PSAM:

Choose PSAM - select which PSAM to slide along the upstream sequence to generate a score at each position.

Direction - controls whether to generate a sliding score for the Forward, Backward (Reverse) or both directions. Forward is displayed above the sequence, while Backward is displayed below the sequence.

Filtering:

Threshold - Only show sequences which have a weighted score exceeding the given threshold at some location along the sequence.

Sequence Name - Only show sequences matching the input name.

Image Snapshot

Take Snapshot - Places an image of the sequence view in the Workspace.

Example

In this example, we will use two files that are available here. Right-click on each link and select "Save link as". Download them into a convenient directory. They are SpellmanReduced.txt and Y5_600_Bst.txt. SpellmanReduced.txt contains a subset of the data from Spellman 1998. Y5_600_Bst.txt contains the corresponding upstream DNA sequences for these genes.


1. Right-click on the Workspace node and select "Open File(s)".

2. Browse to where you saved the file SpellmanReduced.txt and set the file type to "Tab-Delimted". Open the file.

3. You will be asked for an annotations file. This is not needed for this example, so you can hit Cancel.

4. Go to the Analysis tab and select Matrix Reduce.

5. To load the sequence file, click the "Load..." button. Browse to the sequence file "Y5_600_Bst.txt" and open it.


MatrixREDUCE Parameters.png


6. Click Analyze to run MatrixREDUCE. (If you are running geWorkbench from a console window using ANT, you can follow the progress of the calculations there).

7. The result is placed as a node beneath the parent microarray dataset in the Workspace. At the same time, the results are displayed in the Visual Area of geWorkbench.

There are two tabs in the viewer, PSAM Detail and Sequence. Within PSAM Detail there are two options. The first is the Image view, which depicts the PSAM graphically.


T MatrixREDUCE PSAM view.png


The second viewing option is the Name view, which just shows the consensus sequence without the weighted components.

T MatrixREDUCE PSAM name view.png


Finally, the Sequence tab depicts scores along each sequence.


T MatrixREDUCE SequenceView.png

References

  • Foat BC, Houshmandi SS, Olivas WM, Bussemaker HJ. (2005). Profiling condition-specific, genome-wide regulation of mRNA stability in yeast. PNAS 102(49), 17675-17680. link to paper
  • Foat BC, Morozov AV, Bussemaker HJ. (2006). Statistical mechanical modeling of genome-wide transcription factor occupancy data by MatrixREDUCE. Bioinformatics 22(14):e141-e149. link to paper
  • Spellman et al., (1998). Comprehensive Identification of Cell Cycle-regulated Genes of the Yeast Saccharomyces cerevisiae by Microarray Hybridization. Molecular Biology of the Cell 9, 3273-3297.