Help:DataVisualizationInCytoscape

From WikiPathways

(Difference between revisions)
Jump to: navigation, search
(removed ClueGO)
Current revision (22:03, 9 November 2018) (view source)
(commented out content)
 
(40 intermediate revisions not shown.)
Line 1: Line 1:
-
'''UNDER CONSTRUCTION'''
+
'''This tutorial has been replaced by the [https://cytoscape.org/cytoscape-tutorials/protocols/wikipathways-app/#/title WikiPathways App Tutorial].'''
-
 
+
<!--
-
This tutorial describes how to visualize experimental data on WikiPathways in Cytoscape. After importing the data, it is mapped to Ensembl identifiers using BridgeDb. A visual style is created, and the data is visualized on pathways imported from WikiPathways. Finally, over-representation analysis is done with the ClueGO app.
+
-
 
+
= Installation =
= Installation =
-
 
=== Cytoscape ===
=== Cytoscape ===
* Download Cytoscape here: http://www.cytoscape.org/.
* Download Cytoscape here: http://www.cytoscape.org/.
Line 12: Line 9:
* In Cytoscape, open the '''App Manager''' under '''Apps > App Manager'''.
* In Cytoscape, open the '''App Manager''' under '''Apps > App Manager'''.
-
[[image:AppManager.png|left|]]<br clear="all" />
+
[[image:AppManager.png|650px|left|]]<br clear="all" />
-
* In the search field, type ''WikiPathways'' to search for the WikiPathways app. In the search results, select the WikiPathways app and click '''Install'''.
+
* In the search field, type ''WikiPathways'' to search for the WikiPathways app. Select the WikiPathways app from the results and click '''Install'''.
-
* Next, find and install the BridgeDb app in the same way. When the installation is complete, click '''Close''' to exit the '''App Manager'''.
+
* When the installation is complete, click '''Close''' to exit the '''App Manager'''.
Alternatively, Cytoscape apps can be installed directly from the Cytoscape App Store. If Cytoscape is open on your computer, you can click '''Install''' on the relevant app page, and the app will install.  
Alternatively, Cytoscape apps can be installed directly from the Cytoscape App Store. If Cytoscape is open on your computer, you can click '''Install''' on the relevant app page, and the app will install.  
Line 21: Line 18:
[http://apps.cytoscape.org/apps/wikipathways WikiPathways app]
[http://apps.cytoscape.org/apps/wikipathways WikiPathways app]
-
[http://apps.cytoscape.org/apps/bridgedb BridgeDb app]
+
= Pathway import and mapping =
 +
 
 +
=== Import pathways from WikiPathways ===
 +
 
 +
Based on over-representation analysis, two pathways have been identified as significant for this dataset. To start, we will open these pathways.
 +
 
 +
* Locate the search field at the top of the Network Panel and choose WikiPathways from the pulldown options.
 +
* Type in ''Electron Transport'' and hit '''Enter''' or click the icon to search.
 +
* In the results dialog, check the  box for '''Only''' and select '''Mus musculus''' in the species drop-down.
 +
* In the pathway results, select the Electron Transport Chain and either double-click on the entry to open, or click on the '''Import as Pathway''' button at the bottom right. Once opened, the pathway should look like this:
 +
 
 +
[[image:WPSearchResults.png|900px|left|]]<br clear="all" />
 +
 
 +
Once the pathway opens in Cytoscape, it should look like this:
 +
 
 +
 
 +
[[image:ElectronTransport.png|1100px|left|]]<br clear="all" />
 +
 
 +
 
 +
* Repeat the steps above to search for ''Proteasome'' and import the '''Proteasome degradation''' pathway.
 +
* You should now have both pathways open in Cytoscape:
 +
 
 +
[[image:PathwaysInCytoscape.png|1100px|left|]]<br clear="all" />
 +
 
 +
=== Identifier Mapping ===
 +
In the Table Panel you can see that the gene identifiers in these pathways from Ensembl. It turns out that the experimental data we will be using in this example is also annotated with Ensembl identifiers. But this is not always the case! Fortunately, it is very easy to get a new column of identifiers in any of the major types.  In this example, we will go ahead and add a column of Entrez Gene IDs to demonstrate this functionality.
 +
 
 +
* In the Table Panel, right click on the column header '''XrefId''' which contains the identifiers for the data nodes.
 +
* Choose '''map column''' to bring up the ID Mapping dialog
 +
* Select the following:
 +
** Species: '''Mouse'''
 +
** Map from: '''Ensembl'''
 +
** To: '''Entrez'''
 +
* Then click '''OK'''
 +
* Now you have a new column of Entrez Gene IDs (all the way to the right)
-
= Data import and mapping =
+
'''Note that the WikiPathways app automatically adds Ensembl identifiers to pathways upon import. This means that manually annotating the pathway is only necessary if the data is annotated with a system other than Ensembl.'''
-
=== Download the data ===
+
= Data import =
-
For this tutorial, we will use an example dataset of transcriptional profiling of mouse embryonic stem cells and embryoid bodies. The data is in the form of a text file.  
+
=== Download data ===
 +
For this tutorial, we will use an example dataset describing intestinal changes in response to fasting in mice. The data gene expression array data, and is in the form of a text file.  
-
The experimental data for this tutorial can be found here: [http://opentutorials.cgl.ucsf.edu/images/7/75/MusMusculus_ES-EB_25000.txt MusMusculus_ES_EB.txt].
+
The experimental data for this tutorial can be found here: [http://opentutorials.cgl.ucsf.edu/images/f/f7/Starvation_dataset_trans.txt Starvation_dataset_trans.txt].
-
=== Data import ===
+
Source: [http://bmcgenomics.biomedcentral.com/articles/10.1186/1471-2164-8-361 Sokolovic et al. BMC Genomics. 2007 Oct 9;8:361]
-
* To import the experimental data, select '''File > Import > Table > File...'''. Select the ''MusMusculus_ES_EB.txt'' file and click '''Open'''.
+
-
* Choose a name for the new data table, for example '''ES_EB'''. Click '''OK''' to import.
+
-
[[image:DataImport.png|left|]]<br clear="all" />
+
=== Import data to Cytoscape ===
 +
* To import the experimental data, select '''File > Import > Table from File...'''. Select the ''starvation_dataset_trans.txt'' file and click '''Open'''.
 +
* Under '''Where to Import Table Data''', choose '''To selected networks only'''.
 +
* To select both pathways, click the '''Select All''' button.
 +
* Under '''Key Column for Networks''', select '''XrefId''' (the column with Ensembl IDs).
 +
* In the '''Preview''' section, click the expand symbol at the top of the '''ensid''' column. This will open an interface where you can define the details of the column, such as data type etc.
 +
* For the purposes of this tutorial, click the key symbol. This defines the '''ensid''' column as being the key column, which will be used to link the data to the pathways.
-
=== Identifier mapping with BridgeDb ===
+
[[image:DataImport.png|600px|left|]]<br clear="all" />
-
Since the data is annotated with Affymetrix probe set identifiers, it needs to be mapped to a standard identifier type to visualize it on pathways. The BridgeDb app does exactly this, given a mapping file. Before performing the mapping, we have to import the appropriate mapping file to BridegDb.
+
-
* Open the BridgeDb app under '''Apps > BridegDb > Manage ID Mapping Resources'''.
+
* Click '''OK''' to import the data.
-
[[Image:BridegDb_Resources.png|left|]]<br clear="all" />
+
= Data visualization on pathways =
-
BridgeDb works with mapping information from various sources. For example, y ou can either download a database [http://www.pathvisio.org/downloads/download-bridgedbs/ here], and after extracting it you can select it under '''Databases''' in the '''ID Mapping Resouces Configuration''' interface. You can also supply a local or remote mapping file.
+
The data and pathways are now both imported and linked and we can visualize the data on the pathways. For this tutorial, we will create a color scheme for all significant nodes, based on ANOVA values for a comparison across three experimental groups.
-
For this tutorial, we will use Web Services for the mappings.
+
-
* Click on the '''Web Services''' entry in the list of ID mapping sources.
+
* In the '''Control Panel''' on the left side of Cytoscape, select the '''Style''' tab.
-
* In the '''Webservice-based ID Mapping Resources Configuration''' interface, select '''BridegDb web service''' in the drop-down.
+
* In the list of '''Properties''' click on the triangle next to '''Fill Color''' to expand.
 +
* Click on '''Fill Color''' next to Column. In the drop-down, select '''ANOVA''' to select the ANOVA column from the data.
 +
* Under '''MappingType''', select '''Continous Mapping'''.  
-
[[Image:BridgeDb_webservice.png|left|]]<br clear="all" />
+
[[image:ContinousDefault.png|left|]]<br clear="all" />
-
* In the '''Base URL of BridgeDb web service''' drop-down, select the entry for mouse. Click '''OK''' to continue.
+
* Double-click on the default color continuum to customize it.
 +
* Set the min/max values by clicking the '''Set Min and Max...''' button. Set Min to 0 and Max to 0.05.
 +
* Set the colors for both min and max by double-clicking on the small triangles and choosing a shade of green.
 +
* For the large right-most triangle, set the color to a pale gray color.  
-
You will see a listing of supported ID systems, note that Affymetrix is listed. We are now ready to perform the mapping.
+
You now have a color scheme where nodes with an ANOVA value of 0.05 or below is colored green, and all other measured nodes are colored gray. Nodes that are not found will simply be white.
-
[[Image:BridgeDb_Config.png|left|]]<br clear="all" />
+
[[image:PathwayViz.png|left|]]<br clear="all" />
-
* Close the '''ID Mapping Source Configuration''' interface.
+
=== Export visualizations ===
-
* Select '''Apps > BridegDb > Map Identifiers'''.
+
Any pathway or network visualization in Cytoscape can be exported into a number of graphical file formats, which can easily be included in publications and websites. File formats supported for export are PNG, JPEG, PDF, PostScript and SVG.  
-
= Viewing data on pathways =
+
* To export the pathway visualization, select '''File > Export > Network View as Graphics...'''
 +
* Select the export file format, and designate a location name filename for the export.
-
=== Open WikiPathways in Cytoscape ===
+
[[image:ExportPathway.png|left|]]<br clear="all" />
-
=== Visual Styles ===
+
-->

Current revision

This tutorial has been replaced by the WikiPathways App Tutorial.

Personal tools