Help:DataVisualizationInCytoscape

From WikiPathways

(Difference between revisions)
Jump to: navigation, search
(→Identifier mapping with BridgeDb)
Current revision (22:03, 9 November 2018) (view source)
(commented out content)
 
(31 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 standard identifiers using BridgeDb. A visual style is created, and the data is visualized on pathways imported from WikiPathways.  
+
-
 
+
= 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 =
-
= Data import and mapping =
+
=== Import pathways from WikiPathways ===
-
 
+
-
=== Download the data ===
+
-
For this tutorial, we will use an example dataset describing intestinal changes in response to fasting. The data is in the form of a text file.
+
-
 
+
-
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].
+
-
 
+
-
=== Open pathways ===
+
Based on over-representation analysis, two pathways have been identified as significant for this dataset. To start, we will open these pathways.
Based on over-representation analysis, two pathways have been identified as significant for this dataset. To start, we will open these pathways.
-
* Go to '''File > Import > Network > Public Databases...'''. In the '''Data Source''' drop-down, select WikiPathways.
+
* 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:ImportNetworkDatabase.png|left|]]<br clear="all" />
+
[[image:WPSearchResults.png|900px|left|]]<br clear="all" />
-
* Check the box for '''Only''' and select '''Mus musculus''' in the species drop-down.
+
Once the pathway opens in Cytoscape, it should look like this:
-
* In the search field, type in ''Electron Transport Chain''. Click '''Enter''' to search.
+
-
[[image:WPSearchResults.png|left|]]<br clear="all" />
 
-
* In the pathway results, select the Electron Transport Chain and either double-click on the entry to open, or click ont he '''Import as Pathway''' button at the bottom right. Once opened, the pathway should look like this:
+
[[image:ElectronTransport.png|1100px|left|]]<br clear="all" />
-
[[image:ElectronTransport.png|left|]]<br clear="all" />
 
-
* Repeat the steps above to import the '''Proteasome degradation''' pathway.
+
* Repeat the steps above to search for ''Proteasome'' and import the '''Proteasome degradation''' pathway.
* You should now have both pathways open in Cytoscape:
* You should now have both pathways open in Cytoscape:
-
[[image:PathwaysInCytoscape.png|left|]]<br clear="all" />
+
[[image:PathwaysInCytoscape.png|1100px|left|]]<br clear="all" />
-
=== Identifier mapping with BridgeDb ===
+
=== Identifier Mapping ===
-
Since the data is annotated with Ensembl identifiers and the pathways have a mix of identifiers, the pathways need to be mapped to Ensembl before the data can be visualized. The BridgeDb app does exactly this, given a mapping file. Before performing the mapping, we have to import the appropriate mapping file to BridegDb.
+
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.
-
* Open the BridgeDb app under '''Apps > BridegDb > Manage ID Mapping Resources'''.
+
* 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)
 +
'''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.'''
-
[[Image:BridegDb_Resources.png|left|]]<br clear="all" />
+
= Data import =
 +
=== 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.
-
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 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].
-
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 '''Webservice-based ID Mapping Resources Configuration''' interface, select '''BridegDb web service''' in the drop-down.
+
-
 
+
-
 
+
-
[[Image:BridgeDb_webservice.png|left|]]<br clear="all" />
+
-
 
+
-
* In the '''Base URL of BridgeDb web service''' drop-down, select the entry for mouse. Click '''OK''' to continue.
+
-
 
+
-
You will see a listing of supported ID systems. We are now ready to perform the mapping.
+
-
 
+
-
 
+
-
[[Image:BridgeDb_Config.png|left|]]<br clear="all" />
+
-
* Close the '''ID Mapping Source Configuration''' interface.
+
Source: [http://bmcgenomics.biomedcentral.com/articles/10.1186/1471-2164-8-361 Sokolovic et al. BMC Genomics. 2007 Oct 9;8:361]
-
We are now ready to map the identifiers from the pathways to Ensembl. BridgeDb works best when you know the type of identifier to map from (Source).  
+
=== Import data to Cytoscape ===
-
* To find out which identifier type(s) is used in your pathway, first select all nodes on the pathway by clicking and dragging to select the entire pathway. Selected nodes will turn yellow.
+
* To import the experimental data, select '''File > Import > Table from File...'''. Select the ''starvation_dataset_trans.txt'' file and click '''Open'''.
-
* Immediately below the network view in Cytoscape is the '''Table Panel'''. Expand the table either by clicking dragging on the table border, or by click on the '''Float Window''' icon on the right end of the Table Panel border.  
+
* Under '''Where to Import Table Data''', choose '''To selected networks only'''.
-
* The identifier types for data nodes are listed in the '''XrefDatasource''' column. The 4 pathways in this tutorial are annotated with a mix of Entrez Gene, MGI and Ensembl identifiers.  
+
* 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.
 +
[[image:DataImport.png|600px|left|]]<br clear="all" />
-
[[Image:DataNodeTable.png|left|]]<br clear="all" />
+
* Click '''OK''' to import the data.
-
* With one of the networks selected, go to '''Apps > BridegDb > Map Identifiers'''.
+
= Data visualization on pathways =
-
* In the BridgeDb interface, open the drop-down under '''Source ID Type(s)''', and select Ensembl, Entrez Gene and MGI in the list of identifier types.
+
-
* In the '''Source Column in Node Table''', select '''XrefId''', which is the column that contains the identifier for WikiPathways.
+
-
* In the '''Target ID Type''', select Ensembl. The '''Target Column in Node Table''' will default to '''Ensembl''', which will be a new column in the ''''Table Panel''' for the pathway.
+
-
* Finally, in the '''All Target ID(s) or First Only?''' drop-down, select '''Keep the first target ID only'''.
+
-
The interface should now look like this:
+
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.
 +
* In the '''Control Panel''' on the left side of Cytoscape, select the '''Style''' tab.
 +
* 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:BridgeDbMapping.png|left|]]<br clear="all" />
+
[[image:ContinousDefault.png|left|]]<br clear="all" />
-
* Click '''OK''' to run the mapping. When the mapping is complete, you will get a message stating how many identifiers were converted, and a question about running additional mapping. Click '''No''' to close BridgeDb.
+
* 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.  
-
* Repeat the mapping process with the Urea cycle pathway.
+
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.
-
=== Data import ===
+
[[image:PathwayViz.png|left|]]<br clear="all" />
-
* To import the experimental data, select '''File > Import > Table > File...'''. Select the ''starvation_dataset_trans.txt'' file and click '''Open'''.
+
-
* Select the pathway collection created earlier to import the data to......
+
-
* Select the appropriate key column......
+
-
[[image:DataImport.png|left|]]<br clear="all" />
+
=== Export visualizations ===
 +
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.

Retrieved from "https://classic.wikipathways.org/index.php/Help:DataVisualizationInCytoscape"
Personal tools