= Semantic Network Summary Parameter Tutorial = == Outline == This tutorial will guide a user through how to use and manipulate the parameters associated with the Semantic Network Summary plugin using the Cytoscape session file provided. See the Semantic Summary [[GSoC2010_UseExamples|Basic Tutorial]] for an introduction to using the Semantic Network Summary. Pre-requisites - * Cytoscape >= 2.6.3 must be installed * The Semantic Network Summary plugin must be in the Cytoscape-v2.x.x/plugins folder * Download the test data Go to this page to [[GSoC2010_SoftwareDownload|download the plugin and test data]] == Instructions == === Version 0.5 or newer === 1. Open Cytoscape 2. Open the provided [[GSoC2010_SoftwareDownload|sample data file]] (File / Open / select the file AlzheimerEM.cys) 3. Be careful not to change the set of selected nodes for the network titled "EM1_Enrichment Map" as this will change the results that you will get. '''The example network with the correct set of nodes selected:''' ''' {{attachment:Selected_Nodes.png|Selected_Nodes.jpg}} ''' 4. Create a cloud using the nodes already selected in the nodes already pre-selected in the network. Change the node attribute used for the semantic analysis to EM1_GS_DESCR and update the cloud. From here forth we will refer to this as the "Original Cloud". '''Expected Original Cloud:''' {{attachment:Original_Cloud.png|Original_Cloud.jpg}} 5. Expand the Advanced parameters section of the Input Panel. Change the '''Max Num of Words''' from the default of 250 to 5 and create a new cloud. This will cause only the top 5 most significant words to appear in your cloud. * Word significance is determined by the size of the word. If you have cloud display style selected that includes clustering (which you do for this example) ties are broken using cluster membership. Also, notice that clusters are organized by decreasing order of importance where importance is determined using both the number of words appearing in a cluster as well as their size. '''Expected Result:''' ''' {{attachment:Max_Word_Cloud.png|Max_Word_Cloud.jpg}} ''' 6. Select the original cloud from your list of clouds. Change the '''Network Normalization '''from 0.5 to 0 and create a new cloud. * Setting the Network Normalization to 0 means that the size that the words appear in the cloud is directly proportional to how often they appear in the selected nodes - no weight is given to how often they appear in the whole network. In this example, Cancer is the largest word in the cloud, which means that it is the most frequently appearing word in the selected nodes. * Since changing the Network Normalization parameter affects the relative importance for each word, changing its value also affects how clustering occurs. A user should expect that changing this parameter will likely change how the words for a cloud are clustered. '''Expected Result:''' ''' {{attachment:Network_Normalization.png|Network_Normalization.jpg}} ''' 7. Select the original cloud from you list of clouds. Change the '''Word Aggregation Cutoff '''from 1 to 50 and create a new cloud. * Setting the Word Aggregation Cutoff to 50 for this cloud places this value higher than the word aggregation value for all pairs of words that appear in the selected nodes. As a result, each word will be in its own cluster for this example. * In general, a higher Word Aggregation Cutoff value means that the requirements for clustering are more stringent and as a result there will be more, smaller clusters. * In general, a lower Word Aggregation Cutoff value (minumum of 0) means that the requirements for clustering are less stringent and as a result there will be fewer, larger clusters. However, since our clustering algorithm takes into account the order that the words appear, it is unlikely that a Word Aggregation Cutoff value of 0 will result in a single large cluster. '''Expected Result:''' {{attachment:Word_Aggregation_Cutoff.png|Word_Aggregation_Cutoff.jpg}} 8. Select the original cloud from your list of clouds. In the '''Word Exclusion List''' section of the input panel add the word "cancer" to be excluded (hit the add button after typing the word). Create a new cloud. * The word cancer will no longer appear in the newly created cloud. '''Expected Result:''' ''' {{attachment:Add_Cancer.png|Add_Cancer.jpg}} ''' 9. Select the original cloud from your list of clouds. In the '''Word Exclusion List''' section of the input panel expand the word removal list. Under the section with the heading --Flagged Words-- select the word "kegg". Hit the Remove button and create a new cloud. * The word "kegg" is no longer being filtered out and will now appear in the word tag cloud. * Since the word exclusion list is stored at the network level, the word "cancer" will continue to no longer appear in the newly created cloud. '''Expected Result:''' ''' {{attachment:Remove_KEGG.png|Remove_KEGG.jpg}} ''' 10. Select the original cloud from your list of clouds. In the '''Cloud Layout '''section of the input panel select Clustered-Boxes and create a new cloud. * Notice that the changes to the Word Exclusion List are still in effect. '''Expected Result:''' ''' {{attachment:Boxes.png|Boxes.jpg}} ''' 11. Select the original cloud from your list of clouds. In the '''Cloud Layout '''section of the input panel select No-Clustering and create a new cloud. * Notice that the changes to the Word Exclusion List are still in effect. '''Expected Result:''' {{attachment:No_Clustering.png|No_Clustering.jpg}}