geWorkbench

Revision as of 17:16, 20 November 2012

Overview

MARINa uses gene set enrichment analysis (GSEA) to calculate if the regulon of a TF is enriched for genes that are differentially expressed among 2 classes of microarrays. Following the GSEA runs, MARINa performs an additional "shadow" analyses. The "Synergy" analysis option is not currently supported.

The MARINa algorithm runs on a computational cluster at Columbia and access is restricted. It is run from geWorkbench using a grid service, selected using the "Services" tab.

The MARINa algorithm differs substantially from the "FET" method described in the Master Regulator Analysis chapter.

The list of signature markers is determined using a t-test in the MARINa algorithm, rather than being loaded separately as for the FET method.
The list of candidate Master Regulators is taken from the network, rather than using a separate list as in the "FET" method.
The MARINa method has its own set of parameters.
MARINa will use case and control designations of arrays in the Arrays component if provided. However, unlike the FET method, it will also run if only control arrays are designated. In this case, it will divide the arrays into two groups using its own method and run the t-test on this internal division of arrays.

Inputs

Network - the network (e.g. from ARACNe) upon which MARINa will operate.
GSEA and shadow/synergy analysis run parameters:
- Minimum Number of Targets: minimum number of genes in a regulon for a GSEA run (a positive integer).
- Minimum Number of Samples: minimum number of arrays in the input microarray set in order to run sample-based permutations in GSEA (a positive integer).
- Number of GSEA permuations: number of GSEA permutations to compute enrichment score distribution (a positive integer).
- GSEA Tail: whether 1-tailed (1) or 2-tailed GSEA (2) is to be performed. If all correlations in the network file are greater than zero, then one-tail GSEA will be performed regardless of the value the user assigns to "tail".
- Shadow P-value: significance threshold for shadow analysis.
- SynergyP-value: significance threshold for synergy analysis.
Retrieve prior result with ID (checkbox) - if checked, all parameter fields are disabled and the prior ID field is enabled. The user can retrieve the results of a previous run.

other input

GSEA P-Value: This parameter appears on the "Main" parameters tab. It indicates the enrichment score p-value below which a regulon is considered enriched in differentially expressed genes.

Unpaired/Paired Runs

Normally, the user will specify two classes of arrays, e.g. "case" and "control". Under these conditions, an unpaired calculation is performed. However, if the user only includes one class of array (control), then "paired" runs are performed.

Network alternative 5-column file format

MARINa in geWorkbench will normally be set up to work with a network that is either already in the Project area, or that is loaded from disk in a standard format, e.g. an ARACNe-style adjacency matrix or SIF file. geWorkbench will generate a file in the following 5-column format which is then sent to the remote MARINa service. However, a file in this format can also be directly loaded into the MARINa component. In this case, the values contained in the file are used directly, and are not replaced by values calculated by geWorkbench.

Each line represents a network edge and comprises five tab-delimited columns:

Transcription factor id: A string that provides the transcription factor end of the edge. This is usually a probeset id or a gene symbol.
Target id: A string that provides the target end of the edge. This is usually a probeset id or a gene symbol
Mutual information: The mutual information (MI) of the edge (a real number). If the edge MI is not known/available, the value 1 can be entered here.
Spearman's correlation: The Spearman's correlation for the edge, computed on the original microarray set that gave rise to the ARACNe network (a real number). If not known/available, the value 1 can be entered here.
P-value for Spearman's correlation. The p-value associated with Spearman's correlation found in the previous column (a real number between 0 and 1). It this p-value is not known/available, a value of 0 can be entered here.

Example data files for running MARINa

MARINa runs, even on a large computational cluster, can be very time-consuming. We include here a small test dataset with which to demonstrate running MARINa.

Example data files (.zip). Includes expression file, network file (5-column format) and files defining two microarray classes. The individual files are:

mra_grid_data.exp - Affymetrix File Matrix format expression file.
mra_grid_5colnetwork.txt - A network file matching the expression data. This file is in the "5-column" format and can only be loaded directly into the MRA component. Network files in the adjacency matrix and SIF formats should normally be used, this file is for demonstration only.
mra_grid_ixclass1.csv - array set definition file, for loading into the Arrays component to define phenotype class 1 (Case).
mra_grid_ixclass2.csv - array set definition file, for loading into the Arrays component to define phenotype class 2 (Control).

Running MARINa

Prerequisites

Expression Data - An expression data set must be loaded in geWorkbench.
Phenotypic classes - specified in the Arrays component in the currently active list view.
- Two classes - Normally, "case" (reported as class1) and "control" (reported as class2) array sets should be defined and activated in the Arrays component. There can be no arrays that belong to both classes. If there are, a warning will be displayed and the analysis will not be launched. With two specified classes, the calculation will be run in "unpaired" mode.
- Single class - However, if only one class is present (e.g. if no arrays are marked "case" or activated, then only a single class will be used. In this case, the calculation is run in "paired" mode.
Network file - a network that is already present in the Projects area as a child of the expression dataset can be used, or a network can be loaded directly into the MRA component via its Main tab.

Setting the MARINa Parameters

Please note that MARINa analysis can only be selected in the Services tab as a grid service. Just opening the MARINa parameters tab does not select the MARINa service.

Main Tab

In the Main tab of the MRA component, select or load a network.
Set the desired GSEA p-value.

Please see the description of this tab in the Master Regulator Analysis chapter.

Selecting the MARINa grid service

You must search for and activate the MARINa grid service in the MRA services tab. If the local service is selected it will run the FET method.

The figure below shows the Services tab after the MARINa grid service has been retrieved and selected.

MARINa Tab

Inspect and if desired change the parameters. See the section on "Inputs" above.

Analyze

Push the Analyze button to launch the analysis on the grid service. You will be prompted to enter a grid username and password.

Results

With sample shuffling:

With probe shuffling (note that the MeanClass1 and MeanClass2 columns are omitted when probe shuffling is used):

The MARINa results file contains one line for each TF whose GSEA enrichment score renders it significant above the user-specified p-value threshold (pvalue_gsea), as long as such TF is not "shadowed" by other significant TFs. NOTE: for the time being, we will ignore below (and in our implementation of the grid service) the results of the synergy analysis.

The columns represented in the results are as follows:

TFsym: transcription factor id (usually this is the probeset id).
GeneName: transcription factor gene name.
NumPosGSet: number of genes (among those in the regulon of the transcription factor) which are positively regulated by the TF. Only genes represented in the microarray set are counted.
NumNegGSet: number of genes (among those in the regulon of the transcription factor) which are negatively regulated by the TF. Only genes represented in the microarray set are counted.
NumLedgePos: number of genes (among those counted under the NumPosGSet column) which are in the GSEA leading edge.
NumLedgeNeg: number of genes (among those counted under the NumNegGSet column) which are in the GSEA leading edge.
NumLedge: sum of NumLedgePos and NumLedgeNeg.
ES: GSEA enrichment score for the regulon of the TF.
NES: GSEA normalized enrichment score for the regulon of the TF.
absNES: absolute value of NES
PV: p-value of normalized (?) enrichment score.
OddRatio: (NumLedge/(microarray set genes in the regulon of the TF))/((number of differentially expressed genes left of the leading edge)/(total number of microarray set genes)) - <Aris>please check with Mukesh that this is the correct definition</Aris>.
TScore - t-test t-statistic.
MeanClass1: mean expression value of TF among all "Class 1" arrays.
MeanClass2: mean expression value of TF among all "Class 2" arrays.
Note - there are no MeanClass1 and MeanClass2 when probe shuffling is performed.
Original MRA/Recovered_MRA: a value of 1 in this column means that the TF was found to be enriched by GSEA (above the significance level pvalue_gsea) and that it was not shadowed by any other TF. A value of 0 means that the TF was found to be enriched by GSEA and that it was shadowed by another TF and that it remained enriched even after the common targets with the other TF were removed from its regulon.

@@ Line 65: / Line 65: @@
 * Set the desired GSEA p-value.
-[[Image:MRA_Parameters_MARINa.png]]
+Please see the description of this tab in the [[Master_Regulator_Analysis#Main| Master Regulator Analysis]] chapter.
 ====Selecting the MARINa grid service====