Size: 5966
Comment:
|
Size: 8950
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 27: | Line 27: |
1. Click Start MCODE | 1. Click '''Start MCODE''' |
Line 32: | Line 32: |
* About MCODE | * '''About MCODE''' |
Line 34: | Line 34: |
* Help | * '''Help''' |
Line 37: | Line 37: |
New to Version 1.2: MCODE can now be seen as a console for the underlying algorithm. It can be started independent of network loading. This provides for a more easily accessible, repeatable and modifyable analysis. | ''New to Version 1.2: MCODE can now be seen as a console for the underlying algorithm. It can be started independent of network loading. This provides for a more easily accessible, repeatable and modifyable analysis.'' |
Line 43: | Line 43: |
This section will cover some of the basic steps of running MCODE on a network. | The '''MCODE Main Panel''' is the starting point for analysis. It contains two main sections: '''Scope''' and '''Advanced Options'''. The latter is intended for fine-tuning of results by experienced users who are familiar with the MCODE Paper. It will be discussed in the next secton. This section will cover some of the basic steps of running MCODE on a network. |
Line 52: | Line 52: |
* Selections can be made either in the view directly or in the node browser. | * Selections can be made either in the view directly or Cytoscape's handy search tool. |
Line 76: | Line 76: |
* These results can be discarded at any time by pressing the '''Close''' button at the bottom of the results panel. |
* These results can be discarded at any time by pressing the '''Close''' button at the bottom of the results panel. * '''Network View:''' * If the network being analyzed has a view, MCODE will apply a custom visual style utilizing two MCODE generated node attributes. * '''MCODE_Node_Status:''' Node shapes indicate the cluster status of the nodes. * Square: seed (highest score in the cluster) * Circle: clustered * Diamond: unclustered * '''MCODE_Score:''' Node colors represent the node score. * A range from black to red indicates the MCODE computed node score (lowest to highest, respectively). * White indicates a score of zero. * '''MCODE_Cluster:''' This is an additional list type attribute that indicates which cluster the node belongs to. The MCODE visual style does not make use of it, but it is there in case it may be of some use. Note that if the '''Fluff''' parameter (discussed in the following section) is turned on, some nodes may belong to more than one cluster. * '''Cluster Selection:''' * The clusters in the cluster browser table are selectable and will automatically select the corresponding nodes in the network view (if it exists). If no network view is available, the selected nodes can be reviewed in the Cytoscape native node attribute browser. * Secondly, a new '''Cluster Exploration Panel''' will appear below the Cluster Browser. This panel can be collapsed for now -- it's use will be discussed in the Exploring Results section of this Manual. |
Line 83: | Line 95: |
Line 84: | Line 97: |
By default, MCODE analyzes networks using scoring and finding parameters that have been optimized to produce the best results for the average user and network. However, you may benefit greatly by familiarizing yourself with these parameters. Sometimes even slight customizations can produce considerable differences, reduce unwanted or false results, and increase relevance to your network. This is only an overview -- for a detailed insight into how these parameters function, it is best to consult the MCODE paper. |
|
Line 85: | Line 101: |
1. '''Include Loops''' * If checked, MCODE will include loops (self-edges) in the neighbourhood density calculation. This is expected to make a small difference in the results. 1. '''Degree Cutoff''' * Sets the degree cutoff below which a node will not be scored. For example, nodes that share only one connection with one other node have a degree of 1. It is generally undesirable to include these in clusters and as such, the degree cutoff minimum value is 2. Increasing this parameter will filter out less interconnected nodes and will cause MCODE to return only the more interconnected clusters. |
|
Line 86: | Line 107: |
1. '''Haircut''' 1. '''Fluff''' * '''Node Density Cutoff''' 1. '''Node Score Cutoff''' 1. '''K-Core''' 1. '''Max. Depth''' |
|
Line 88: | Line 116: |
=== Size Slider === === Node Attribute Enumerator === |
|
Line 91: | Line 121: |
== Tutorials == | == Tutorials (Coming Soon) == |
Line 93: | Line 123: |
---- == Troubleshooting == === General === * MCODE Does Not Appear in the Plugins Menu === Error Messages === |
MCODE User's Manual
Installation
To use the MCODE PlugIn, you must first obtain a copy of Cytoscape. The compatible MCODE and Cytoscape versions are outlined in the downloads section on the [:Software/MCODE: MCODE website]. The lastest MCODE, version 1.2, requires Cytoscape 2.3.2 or later.
You can download a copy of Cytoscape from: http://www.cytsoscape.org.
Once you have downloaded Cytoscape and verified that it works, proceed with the next steps:
- Copy the MCODE.jar file to your [Cytoscape_Home]/plugins directory.
- Start Cytoscape. For example
- On Unix/Linux or MacOS X, run: cytoscape.sh
- On Windows, run: cytoscape.bat
- Check that MCODE appears in the Plugins menu of Cytoscape
- If it does not, then you likely placed the MCODE.jar file in the wrong directory. Repeat step one. You will have to restart Cytoscape to reload the plugin.
Running MCODE
MCODE is an extension for Cytoscape and can only be accessed through Cytoscape.
- Start Cytoscape
- Go to the Plugins Menu
- Move the mouse over MCODE
Click Start MCODE
- The main MCODE interface will appear as a tab in the left-hand panel of Cytoscape
Note: If MCODE does not appear in the Plugins Menu, then the installation of MCODE was not successfull. Please refer to the previous section of the User's Manual.
This menu provides two additional options:
About MCODE
- A quick reference to MCODE acknowledgements, citation information, and a link to the MCODE paper.
Help
- A link that will open the MCODE website at [:Home: www.baderlab.org] in your default browser for quick access to downloads, contact information, and the User's Manual with help and tutorials.
New to Version 1.2: MCODE can now be seen as a console for the underlying algorithm. It can be started independent of network loading. This provides for a more easily accessible, repeatable and modifyable analysis.
Getting Results
The MCODE Main Panel is the starting point for analysis. It contains two main sections: Scope and Advanced Options. The latter is intended for fine-tuning of results by experienced users who are familiar with the MCODE Paper. It will be discussed in the next secton. This section will cover some of the basic steps of running MCODE on a network.
- LOAD YOUR NETWORK. To begin, make sure the network to be analyzed is loaded into Cytoscape. You can load as many networks as your computer system can handle, large or small. MCODE will recognize which network you wish to analyze either by noting which network view is on top or by your selection of the network in the Network Tab on the left-hand panel.
CHOOSE THE SCOPE. Cluster results can be reported in two fundamental ways with MCODE. This is referred to as the Scope of the process.
- Find Clusters in Whole Network
- MCODE will find and report all clusters in the entire network.
- Find Clusters from Selection
- Only those clusters including the selected node(s) as one of their members will be reported.
- Selections can be made either in the view directly or Cytoscape's handy search tool.
- The choice of scope is dependent on the your familiarity with the network in question and the desired outcome. Having a particular protein of interest within a network, for example, it may be appropriate to search for only those clusters involving such a protein. On the other hand, uniformed, exploratory work will most benefit from a whole network scope.
- Find Clusters in Whole Network
ANALYZE YOUR NETWORK. Next, press Analyze. This will display a task monitor reporing the progress of the scoring, finding, and drawing steps, provided that the task is not too quick.
- You may see several different messages at this step:
- The "No network" message
- This means that MCODE failed to detect a loaded network for analysis. You must load a network, and make sure it is selected, before you can anaylze it.
- The "No selection" message
- This message appears when the Selection Scope is used without an actual selection. You must select the desired node(s) before you MCODE can attempt to find clusters.
- The "Parameters unchanged" message
- Parameters are discussed in detail in the following section. For now, you should know that if you attempt to analyze a network twice without changing any of the settings, such as scope, MCODE will let you know that this analysis was previously conducted and will consequently display the previously attained results.
- The "No network" message
- You may see several different messages at this step:
- BROWSE YOUR RESULTS. If everything goes to plan, a new tab will appear in the right-hand panel displaying the results as "Results 1"
Cluster Browser:
- On the left side is a graphical representation of the cluster.
- Cluster members are coloured red.
The highest scoring node in the cluster is called the Seed. It is the node from which the cluster was derived and is represented by a square shape.
- Other cluster members are circular.
- Edges, representing interactions for example, are blue.
- Edge directionality is represented by cyan arrows.
- On the right side is a statisical summary of the cluster.
Rank is based on the cluster's computed Score and is used to ID the clusters within each result set.
- For example, Cluster 1 is the highest ranked cluster in a given result set, and thus, at the top of the list.
Nodes and Edges is a simple enumeration of the clusters members and their interconnections.
These results can be discarded at any time by pressing the Close button at the bottom of the results panel.
- On the left side is a graphical representation of the cluster.
Network View:
- If the network being analyzed has a view, MCODE will apply a custom visual style utilizing two MCODE generated node attributes.
MCODE_Node_Status: Node shapes indicate the cluster status of the nodes.
- Square: seed (highest score in the cluster)
- Circle: clustered
- Diamond: unclustered
MCODE_Score: Node colors represent the node score.
- A range from black to red indicates the MCODE computed node score (lowest to highest, respectively).
- White indicates a score of zero.
MCODE_Cluster: This is an additional list type attribute that indicates which cluster the node belongs to. The MCODE visual style does not make use of it, but it is there in case it may be of some use. Note that if the Fluff parameter (discussed in the following section) is turned on, some nodes may belong to more than one cluster.
- If the network being analyzed has a view, MCODE will apply a custom visual style utilizing two MCODE generated node attributes.
Cluster Selection:
- The clusters in the cluster browser table are selectable and will automatically select the corresponding nodes in the network view (if it exists). If no network view is available, the selected nodes can be reviewed in the Cytoscape native node attribute browser.
Secondly, a new Cluster Exploration Panel will appear below the Cluster Browser. This panel can be collapsed for now -- it's use will be discussed in the Exploring Results section of this Manual.
This is a screeen shot of the MCODE Main Panel and Cluster Browser
- attachment:main_panel.gif attachment:cluster_browser.gif
Fine-Tuning Results
By default, MCODE analyzes networks using scoring and finding parameters that have been optimized to produce the best results for the average user and network. However, you may benefit greatly by familiarizing yourself with these parameters. Sometimes even slight customizations can produce considerable differences, reduce unwanted or false results, and increase relevance to your network. This is only an overview -- for a detailed insight into how these parameters function, it is best to consult the MCODE paper.
Scoring Parameters
Include Loops
- If checked, MCODE will include loops (self-edges) in the neighbourhood density calculation. This is expected to make a small difference in the results.
Degree Cutoff
- Sets the degree cutoff below which a node will not be scored. For example, nodes that share only one connection with one other node have a degree of 1. It is generally undesirable to include these in clusters and as such, the degree cutoff minimum value is 2. Increasing this parameter will filter out less interconnected nodes and will cause MCODE to return only the more interconnected clusters.
Finding Parameters
Haircut
Fluff
Node Density Cutoff
Node Score Cutoff
K-Core
Max. Depth
Exploring Results
Size Slider
=== Node Attribute Enumerator ===
Outputting Results
Tutorials (Coming Soon)
BiNGO Validation