Difference between revisions of "Marker Annotations"

(Changes in geWorkbench 2.5.0)
 
(46 intermediate revisions by 3 users not shown)
Line 5: Line 5:
  
  
==Outline==
 
In this tutorial, we will:
 
#. Load a set of markers into the Markers component.
 
#. Retrieve annotations from NCI's CGAP database.
 
#. View a gene annotation page.
 
#. View a BioCarta pathway diagram in the caBIO Pathways viewer.
 
  
 
==Overview==
 
==Overview==
The Marker Annotations component retrieves two types of information for a group of genes.  It retrieves links to pages from the CGAP database at NCI containing textual information.  It also contains links to BioCarta pathway diagrams provided through NCI's caBIO data service.  For this tutorial, we will examine a group of genes selected in  the '''Hierarchical Clustering''' tutorial. 
 
  
==Loading a set of markers==
+
The Marker Annotations component enables the retrieval of biological annotation information for a collection of genes. For every gene, the following data can be retrieved:
  
You must select and activate a group of markers (genes) in the Markers component. You can use for example the 84 markers selected in the hierarchical clustering example.  However, as it takes about 5 seconds to retrieve the annotations for each marker, you can also load or select a smaller set of markers.
+
* Links to gene detail pages.
 +
* A set of pathways containing the gene.  
  
* To load a previously saved set of markers, go to the Markers component and click the "Load Set" button.
+
* The set previously obtained via hierarchical clustering is in the tutorial data file "cluster_tree_total_pearsons_84_markers.csv".
+
All annotations are retrieved from remote servers maintained by the National Cancer Institute (NCI) [http://biodbnet.abcc.ncifcrf.gov/ bioDBnet resource of the Advanced Biomedical Computing Center] (NCI Frederick).
* The desired marker set should be activated by checking its box in the '''Marker Sets''' component. Here is an example using the data from the [[Tutorial_-_Clustering|Hierarchical Clustering]] tutorial:
 
  
 +
==Submit Query==
 +
The Marker Annotations module will retrieve information for all markers that belong to activated marker sets, or, more precisely, for the genes corresponding to those markers:
  
[[Image:Tutorial-Markers-ClusterTree84.png]]
+
[[Image:MarkerAnnotations_Marker_set_activation.png]]
  
  
==Retrieving selected annotations==
 
  
  
* In the '''Marker Annotations''' component, select '''Retrieve Annotations'''.  A portion of the returned results are shown below:
 
  
 +
E.g., in the example shown above, information will be retrieved about the genes STAT3 and CEBPB.  Clicking the "Retrieve Annotations" button initiates the communication with the remote server:
  
  
[[Image:T_MarkerAnnotations_ClusterTree2.png]]
 
  
 +
[[Image:MarkerAnnotations_Controls.png|{{ImageMaxWidth}}]]
  
==Displaying annotations and pathway diagrams==
 
  
  
* The links under the heading '''Gene''' can be clicked to display information from the CGAP database at the NCI:
+
While the information is being retrieved, a progress bar will be shown.
  
  
 +
[[Image:MarkerAnnotations_ProgressBar.png]]
  
[[Image:T_MarkerAnnotations_GenePage.png]]
+
==Pathway and Gene Annotations==
 +
The "Annotations" tab presents a summary listing of the annotations retrieved from bioDBnet:
  
 +
[[Image:MarkerAnnotations_Results.png|{{ImageMaxWidth}}]]
  
The '''Pathway''' links can be clicked to display BioCarta pathway diagrams provided through the NCI's caCORE/caBIO resource.  The graphical components are themselves clickable to provide further information.
 
  
* Click a pathway link.
+
The listing contains at least one row for each gene which annotation information is available for. If a gene is associated with more than one pathways, then one row for every pathway is listed (e.g., as is the case above for STAT3). Every row displays the marker (i.e., probeset) id, the corresponding gene name and the name of the associated pathway.  
* Go to the caBIO Pathway viewer component. Below is displayed the pathway for the gene viewed above.
 
  
 +
Right-clicking on a gene name shows the following menu options.  Each will link to the named data source to display gene information in your browser:
  
[[Image:T_MarkerAnnotations_h_ppara_Pathway.png]]
 
  
 +
[[Image:MarkerAnnotations_Gene_Menu.png]]
  
==New Content==
 
[[Image:Biocarta.png]]
 
  
[[Image:CGAP_click_on_gene.png]]
+
* '''Go to Entrez for ''gene name'''''
 +
* '''Go to CGAP for ''gene name'''''
 +
* '''Go to GeneCards for ''gene name'''''
  
[[Image:CGAP_summary_page.png]]
 
  
[[Image:CGI_expanded.png]]
+
Right-clicking on a pathway brings up a popup menu offering the following options:
  
[[Image:CGAP_summary_page_gene.png]]
 
  
[[Image:CGI_expanded.png]]
+
[[Image:MarkerAnnotations_Pathway_Menu.png]]
  
[[Image:CGI_disease_dropdown.png]]
 
  
[[Image:CGI_summary_page.png]]
 
  
[[Image:Data_source_checkboxes.png]]
+
* '''View Diagram''': available only for BioCarta pathways. geWorkbench generates a diagram of the pathway based on the BioCarta description. Selecting the "View Diagram" option will display this diagram within the "Pathway" tab.
 +
* '''View Diagram on BioCarta site''' - View the BioCarta diagram in your browser directly on the BioCarta website.
 +
* '''Add pathway genes to set''': extracts the pathway genes for which there are associated probes in the microarray set currently selected by the user and places all such probes in a new marker set within the "Markers" component (by default, the marker set is named after the pathway).
 +
* '''Export genes to CSV''': creates a new text file containing a listing of all pathway genes. The file format (csv = comma separated values) is compatible with Microsoft Excel.  
  
[[Image:Data source checkboxes.png]]
+
The export file contains the following columns:
 +
* Marker
 +
* Gene
 +
* Entrez GeneId
 +
* Pathway
 +
* Entrez URL
 +
* CGAP URL
 +
* GeneCards URL
  
[[Image:NCI_thesaurus_disease_big.png]]
 
  
[[Image:NCI_thesaurus_disease_small.png]]
 
  
[[Image:Pubmed.png]]
+
[[Image:MarkerAnnotations_h_erkPathway.png]]
  
[[Image:Select_marker_sets.png]]
+
 
 +
A BioCarta pathway image is displayed above after selecting the "View Diagram" option from the "Annotations" tab.
 +
* '''pathway dropdown box''' - The drop-down box, on the top left corner above the diagram, shows the name of the currently displayed diagram. The component keeps a history of all BioCarta diagrams selected by the user; using the drop-down it is possible to switch among the corresponding pathway images.
 +
* '''Clear Diagram''' - this button clears the currently displayed diagram.
 +
* '''Clear History''' - this button clears the currently displayed diagram and removes all pathway history information from the pathway name drop-down box.
 +
* '''Image Snapshot''' - save a snapshot of the diagram to the [[Workspace]].
 +
 
 +
==References==
 +
 
 +
Mudunuri,U., Che,A., Yi,M. and Stephens,R.M. (2009) bioDBnet: the biological database network. Bioinformatics, 25, 555-556. [http://www.ncbi.nlm.nih.gov/pubmed/19129209 link to paper]
 +
 
 +
 
 +
[http://www.biocarta.com BioCarta]
 +
 
 +
[http://www.biocarta.com/legal/terms.asp Biocarta Terms of Use]

Latest revision as of 18:27, 22 January 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




Overview

The Marker Annotations component enables the retrieval of biological annotation information for a collection of genes. For every gene, the following data can be retrieved:

  • Links to gene detail pages.
  • A set of pathways containing the gene.


All annotations are retrieved from remote servers maintained by the National Cancer Institute (NCI) bioDBnet resource of the Advanced Biomedical Computing Center (NCI Frederick).

Submit Query

The Marker Annotations module will retrieve information for all markers that belong to activated marker sets, or, more precisely, for the genes corresponding to those markers:

MarkerAnnotations Marker set activation.png



E.g., in the example shown above, information will be retrieved about the genes STAT3 and CEBPB. Clicking the "Retrieve Annotations" button initiates the communication with the remote server:


MarkerAnnotations Controls.png


While the information is being retrieved, a progress bar will be shown.


MarkerAnnotations ProgressBar.png

Pathway and Gene Annotations

The "Annotations" tab presents a summary listing of the annotations retrieved from bioDBnet:

MarkerAnnotations Results.png


The listing contains at least one row for each gene which annotation information is available for. If a gene is associated with more than one pathways, then one row for every pathway is listed (e.g., as is the case above for STAT3). Every row displays the marker (i.e., probeset) id, the corresponding gene name and the name of the associated pathway.

Right-clicking on a gene name shows the following menu options. Each will link to the named data source to display gene information in your browser:


MarkerAnnotations Gene Menu.png


  • Go to Entrez for gene name
  • Go to CGAP for gene name
  • Go to GeneCards for gene name


Right-clicking on a pathway brings up a popup menu offering the following options:


MarkerAnnotations Pathway Menu.png


  • View Diagram: available only for BioCarta pathways. geWorkbench generates a diagram of the pathway based on the BioCarta description. Selecting the "View Diagram" option will display this diagram within the "Pathway" tab.
  • View Diagram on BioCarta site - View the BioCarta diagram in your browser directly on the BioCarta website.
  • Add pathway genes to set: extracts the pathway genes for which there are associated probes in the microarray set currently selected by the user and places all such probes in a new marker set within the "Markers" component (by default, the marker set is named after the pathway).
  • Export genes to CSV: creates a new text file containing a listing of all pathway genes. The file format (csv = comma separated values) is compatible with Microsoft Excel.

The export file contains the following columns:

  • Marker
  • Gene
  • Entrez GeneId
  • Pathway
  • Entrez URL
  • CGAP URL
  • GeneCards URL


MarkerAnnotations h erkPathway.png


A BioCarta pathway image is displayed above after selecting the "View Diagram" option from the "Annotations" tab.

  • pathway dropdown box - The drop-down box, on the top left corner above the diagram, shows the name of the currently displayed diagram. The component keeps a history of all BioCarta diagrams selected by the user; using the drop-down it is possible to switch among the corresponding pathway images.
  • Clear Diagram - this button clears the currently displayed diagram.
  • Clear History - this button clears the currently displayed diagram and removes all pathway history information from the pathway name drop-down box.
  • Image Snapshot - save a snapshot of the diagram to the Workspace.

References

Mudunuri,U., Che,A., Yi,M. and Stephens,R.M. (2009) bioDBnet: the biological database network. Bioinformatics, 25, 555-556. link to paper


BioCarta

Biocarta Terms of Use