Description of the Results panel

The results panel consists in two part: the tool panel on top and the view panel below. Two views are available from iRegulon plugin with their corresponding parameters discussed here in this manual: the Motif View and the Transcription Factor View.

Be careful with the interpretation when using TF view! The TF view helps the user to see the results at the TF focus level, but it is important to keep in mind that a motif can be shared by several members of the same TF family (e.g. GATA factors, ETS factors, E-box TFs) and only one representative will be taken while other TFs are possible.
Heads Up! In motif2TF Table and Target Selection Table, the genes that are already in the current network are highlighted in red.

Tool Panel

Job Name

On the top left, of the Tool panel is the name of the analysis. The parameters of the analysis can be seen when the user put the mouse over this title.

"Add Regulon" Button

This option will add all the target genes and the selected transcription factor to the current network. Edges will be add to the network between the transcription factor and the target genes. This is visualised in the iRegulon Visual Style. The selected view won't be changed.

"Create new network" Button

This option will create a new window in the view, and create a new network. The name of the new network is the name of the selected transcription factor with the name of the selected motif. The selected transcription factor and all target genes will be shown. Also the interaction between these (between the TF and the TG) is drawn. This is visualised in the iRegulon Visual Style.

"Query TF-target database" Button

This option will allow the user to query the metaregulons of the selected TF using our TF-Target database(see query).

"Merge Network" Button

This option will create a new network with the merge of all TF-target gene interactions (one edge per each). The new network will keep the same layout, but the motif information is lost with the edge color.

Warning! Notice that for the moment this option is not available yet in the Cytoscpae 3.1.x version of the plugin.

Selected TF

This menu will show the selected TF and will allow the user to scroll over the predicted TFs.

Search motif, TF or target gene

This menu allows the search of a motif, TF or target gene in the results. The results having the relevant information will be checked in the filter column of the main view table (TF Table in TF view or Motif Table in Motif view).

"Load results" Button

This button will import the results in the iRegulon format (.irf).

"Save results" Button

This button will save the results in the iRegulon format (.irf).

"Export results as a Table" Button

This button will export the results in a tab-delimited text file (.txt).

"Close" Button

This button will close the current results tab and will ask if the user wants to save the results.

iRegulon Visual Style

Cytoscape2 For Cytoscape 2.8.x :

This style draws all target genes as squares. The TF is shown as a green ellipse. The interactions are drawn with directed edges from the TF to the target genes. Edges corresponding to the same motif have the same color.

Cytoscape3 For Cytoscape 3.1.x :

This style draws all target genes as pink ellipses. The TF is shown as a green octagon. The interactions are drawn with directed edges from the TF to the target genes. Edges corresponding to the same cluster have the same cluster color. Circular layout is applied when a new network is drawn or if current network has no edges.

Motif Table (Motif View)

Filtered column

This is linked with the search option. The results having the relevant information will be checked in this filter column. By clicking on the column name, the results will be sorted with the filtered rows on top or bottom of the table.

Rank

This column corresponds to the rank according to the NES score.

Motif ID

The ID of the motif. In general, it corresponds to the source motif database (e.g. transfac_pro, Flyfactorsurvey) and the source ID of the motif.

NES

This column corresponds to the enrichment score of the motif or the maximal enrichment score for a given TF (in TF view).

AUC

This is the Area Under the Curve that is calculated in the cumulative enrichment plot. The AUC is used for the calculation of the enrichment score

Cluster Code

The enriched motifs are clustered by similarity and similar motifs that belong to the same cluster will have the same cluster code and the same background color. The cluster code is given by order of maximal NES per motif cluster. Cluster code starting by "M" corresponds to motif cluster and code with "T" to track cluster.

#Targets

This column indicates the number of target genes selected for the given motif.

#Tfs

This column indicates the number of TFs that can be associated by the motif2TF algorithm to the given motif.

Motif Description

The motif from the selected row is displayed as a motif logo (see weblogo). This logo corresponds to the annotated PWM. Name and link to the source database when possible is added to the description.

Right-click on the logo image to save it to PNG file.

Motif2TF Table

Transcription Factor

Gene ID of the predicted Transcription Factor

Right-click on it, and click on details to get more description about the motif2TF prediction.

Orthologous Identity

This %identity was calculated in EnsemblCompara gene trees based on whole amino acid sequence alignments (tf2tf associations). The closer the score to zero, the more homologous genes can be associated to an annotated TF. But when the threshold is set to zero, no orthologous information is used. This score must be between 0 and 1. "N/A" indicates that orthology identity is not used (e.g. motif annotated for a TF in the same species).

Motif Similarity FDR

This is the FDR calculated by the TOMTOM p-value for the similarity of the motifs (motif2motif associations). The closer the score to zero, the more similar the motif is to the enriched motif. The score must be between 0 and 1. "Direct" indicates that the motif is directly annotated and no motif similarity was used.

Target Selection Table

Target Rank

This is the rank of the target genes according to the score using the selected enriched motif. Top genes are best targets.

Target Name

This is the gene name of the targets. The targets that are in the current network are highlighted in red.

Track View

The Track view shows the enriched regulatory tracks (Transcription Factor, cell line, treatment), similarly as the Motif View.

Consequently, the track view doesn't display motif logo or predicted Transcription Factor from motif2TF. The annotated Transcription Factor (ChIP'ed TF) is then shown in the TF table. Tracks can be clustered if they are associated to the same TF.

TF Table (TF view)

Be careful with the interpretation when using TF view! The TF view helps the user to see the results at the TF focus level, but it is important to keep in mind that a motif can be shared by several members of the same TF family (e.g. GATA factors, ETS factors, E-box TFs) and only one representative will be taken while other TFs are possible.

Transcription Factor

The ID of the Transcription Factor.

#Motifs/Tracks

This column indicates the number of motifs or tracks that can be associated by the motif2TF algorithm to the given cluster.