#acl BaderLabGroup:read,write,revert,delete All: = MCODE User's Manual = [[TableOfContents()]] ---- == 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 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: 1. Copy the MCODE.jar file to your [Cytoscape_Home]/plugins directory. 1. Start Cytoscape. For example * On Unix/Linux or MacOS X, run: cytoscape.sh * On Windows, run: cytoscape.bat 1. 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. 1. Start Cytoscape 1. Go to the Plugins Menu 1. Move the mouse over MCODE 1. 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 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 == This section will cover some of the basic steps of running MCODE on a network. 1. LOAD THE 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. 1. CHOOSE THE SCOPE. Cluster results can be reported in two fundamental ways with MCODE. This is referred to as the '''Scope''' of the process. I. Find Clusters in Whole Network * MCODE will find and report all clusters in the entire network. I. 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 in the node browser. . 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. 1. CLICK ANALYZE. 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: I. 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. I. 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. I. 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. 1. VIEW RESULTS. If everything goes to plan, a new tab will appear in the right-hand panel displaying the results as "Results 1" * These results can be discarded at any time by pressing the '''Close''' button at the bottom of the results panel. ---- == Fine-Tuning Results == === Scoring Parameters === === Finding Parameters === ---- == Exploring Results == ---- == Outputting Results == ---- == Tutorials == === BiNGO Validation === ----