<> = The Cytoscape Test Plan = The purpose of this document is to describe testing procedures to ensure that new releases of Cytoscape do not break existing functionality. The release is broken down into two general sections: '''''Coverage Testing''' and '''''Workflow Testing'''''. '' == Coverage Testing == This section describes tests for Cytoscape that must be run by hand. === File Menu === ==== Open Session File ==== ''Procedure'' 1. Start Cytoscape. 1. Click the "Open Session File" icon on the Toolbar. 1. Open a session file. 1. Download and save [[attachment:corrupted_networkname.cys]] 1. Open that file by clicking File>Open>new Session file ''Expected Results'' 1. The "Open a Session File" dialog should appear. 1. The network contained in the session file should be visible in Cytoscape. 1. Opening the new session file should give a warning message: "Current session will be lost. Do you want to continue?" 1. The attached session file is corrupted: it should lead to an error box: "Cannot open the session file: Session file corrupt: Filename Saccharomyces cerevisiae.xgmml does not correspond to a network of that name in session file" ==== Save Session ==== ''Procedure'' 1. Start Cytoscape. 1. Import galFiltered.gml (or any other gml file that contains visual attributes). 1. Click File->Save. 1. Enter a session name and click Save. 1. Click File->Open 1. Select the session you just saved and click Ok. ''Expected Results'' 1. The session should open. 1. The visual style "galFiltered_gml style" should exist. 1. All visual attributes should exist for the this visual style (assuming galFiltered.gml was loaded). Pay particular attention to the arrows. * Edge color * Edge arrow shape * Edge arrow color * Node Lable ==== Save Current Session As ==== ''Procedure'' 1. Start Cytoscape. 1. Click the "Save Current Session As" icon on the Toolbar. ''Expected Results'' 1. A "Saving Cytoscape Session" status window should appear. ==== Import Menu ==== ===== Network ===== ====== Multiple File Types ====== ''Procedure'' 1. '''File-->Import-->Network (multiple file types)''' 1. Click the '''Select''' button. 1. Choose network ''sampleData/galFiltered.sif'' ''Expected Results'' 1. Both a network and view should be present. 1. All menu options in the '''Select''' and '''Layout''' menus should be enabled. ''Procedure'' 1. '''File-->Import-->Network (multiple file types)''' 1. Click the '''Select''' button. 1. Choose network ''sampleData/BINDyeast.sif'' ''Expected Results'' 1. Only a network should be present in the network panel. 1. No view should be created (based on the rendering threshold). 1. All menu options in the '''Select''' menu should be enabled, but not those in the '''Layout''' menu (because there is no view). ====== From Table ====== ''Procedure'' 1. '''File-->Import-->Network from Table''' 1. Press '''Select File(s)''' button and select text or Excel table network file 1. Select '''Source''', '''Target''', and '''Interaction Type''' 1. Click other columns header to enable edge attribute import. 1. Check '''Show Text File Import Options''' and check '''Transfer first line''' 1. Press '''Import''' ''Expected Results'' 1. Network Table Import GUI will be displayed 1. Preview of the table file will be displayed on '''Preview''' panel. Default delimiters are space and tab. 1. Selected columns will be shown in purple, orange and red. 1. Enabled edge attribute columns are shown in blue. 1. Column header is set to the first line of the table. Column selections should not be lost. 1. A new network will be created. Network name should be the file name of the table. ====== From Web Service ====== ===== Attributes ===== ====== From Table ====== ''Procedure'' 1. Start Cytoscape 1. Load galFiltered.sif 1. Click File->Import->Attributes From Table 1. Click the "Select File" button. 1. Choose file galFiltered.nodeAttrTable.xls (found in both the sampleData and testData dirs). 1. Click the "Show Text File Import Options" in the "Advanced" section of the panel. 1. Click the "Transfer First Line at Attribute Name" checkbox. 1. Click the "Import" button at the bottom left. ''Expected Results'' 1. No exceptions should be thrown, in particular no exception related to the "alias" attribute already existing. 1. Several new attributes should be imported and visible in the attribute browser, including ID, alias, annotation.DB_OBJECT_NAME and others. ==== Export ==== ===== Network as GML ===== ''Procedure'' 1. Start Cytoscape 1. Load a network. 1. Style the network. 1. Click File->Export->Network as GML ''Expected Results'' 1. A gml file should be created. 1. Open the gml file in a text editor and verify: * That all nodes from the network are present. * Each node contains root_index, id, label, and graphics elements. The graphics element should contain x, y, w, h, fill, type, outline, and outline width. * That all edges from the network are present. * Each edge contains root_index, source, target, label, and graphics elements. The graphics element should contain width, fill, source_arrow, target_arrow, type, and a Line array. ==== Zoom out / Zoom in ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Click the "Zoom Out" icon on the Toolbar. 1. Click the "Zoom In" icon on the Toolbar. ''Expected Results'' 1. Clicking "Zoom Out" should result in the view of the network being more zoomed out and less detailed. 1. Clicking "Zoom In" should result in the view of the network being more zoomed in and more detailed. ==== Zoom to display all of current network ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Click the "Zoom to display all of current network" icon on the Toolbar. ''Expected Results'' 1. The view of the network should zoom in or out to fit the entire network in the main window at the highest possible zoom factor. ==== Zoom selected region ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Select a couple of nodes of the network 1. Click the "Zoom selected region" icon on the Toolbar. 1. Click the "Zoom to display all of current network" icon on the Toolbar. 1. Click Select>Mouse drag selects>Edges only 1. Select a couple of edges 1. Click the "Zoom selected region" icon on the Toolbar. ''Expected Results'' 1. The view of the network should zoom in till the selected nodes are at the borders of the view 1. After clicking "display all" the view of the network should zoom out to fit the entire network in the main window. 1. After selecting edges only and zoom selected the network view should zoom in till the endpoints of the selected edges are at the borders of the view ==== Help ==== ''Procedure'' 1. Start Cytoscape. 1. Click the "Help" icon on the Toolbar. ''Expected Results'' 1. The Cytoscape Users Manual should open. ==== Open VizMapper ==== ''Procedure'' 1. Start Cytoscape. 1. Click the "Open VizMapper" icon on the Toolbar. ''Expected Results'' 1. The VizMapper interface should open in Control Panel. ==== Use Filters ==== 1. Start Cytoscape 1. Import a test small network (with less than 1000 nodes/edges) and attributes 1. Click the icon Use filters on toolbar, or click Filters tab on the control panel This will select the filer UI. ===== Define a filter with UI widgets ===== 1. Click ''Option'' icon and select ''create new filter'', enter a filter name 1. Click the plus sign (advanced) to choose what will be selected -- nodes or edges or both 1. Define the filter by adding UI widgets to filter definition panel -- selecting attributes from the attribute/Filter comboBox and click add button 1. Widgets may be removed by click on the trash-can icon at its right 1. Click the radio button (relation) to determine the relationship between the widgets 1. Define the details of the filter by click on appropriate checkbox, not or negation in advanced panel, select appropriate value for each textIndexedComboBox, and move the bar on RangeSlider. Expected results 1. A new filter with given name should appear in the current filter selection comboBox 1. TextedIndexed combobox should be added to the filter definition panel if the selected attribute is type string or simple string list, The UI widget is RangeSliderBar if the attribute is numeric type. 1. When a new widget is added or deleted, or a checkbox/radio button is clicked, the selection on the network view will be made in real time. 1. If there are more than one filter defined, selection of different filter in the current filter comboBox will apply the filter immediately. ===== Define a complex filter ===== After a filter is defined, it will appear in the attribute/filter comboBox when defining other filter, and can then be used by the definition of other filter. Such filters are called complex filter, their behavior should be the same as simple filter defined above and applied in real time. ===== Topology filter ===== Topology filter can select nodes based on its topology (number of neighbors) and properties of their neighbor. Nodes with certain properties can be selected by other filter. 1. Define a filter to select nodes with certain properties 1. Create a topology filter based on the defined filter Expected result The topology filter will be applied in real-time after user make changes to the filter definition ===== Interaction filter ===== Interaction filter will select nodes/edges based on the properties of edges/nodes it connected. Because interaction filter depends on other filter, the menu item Create new (Node/Edge)interaction filter will be disabled if there is no other filter existing. 1. Create a simple filter to select edges only 1. Create a new nodeInteractionFiler 1. Define the nodeInteractionFiler based on the simple filter Expected result The interaction filter will be applied automatically. ===== Read/write filter properties ===== In the advanced panel, there is an option Scope, by default the checkbox session is checked. This option will determine where the filter is saved. 1. Define a filter 1. Check the checkbox global 1. Exit Cytoscape 1. Restart cytoscape Expected result The previous defined filter will appear in the filter comboBox after cytoscape is initialized. ===== Switch network ===== 1. import another network to Cytoscape 1. select the network view just created, then select the other network view Expected result The current selected filter will be applied to the current network if the focused view is changed ===== Large network (more than 1000 nodes/edges) ===== If a network is large enough, with more than 1000 nodes/edge, the filter selected won’t be applied to the network automatically. To apply the filter, click the apply button. By default, the cutoff value for the dynamic filter is 1000 nodes/edges. This value can be changed by defining a property dynamicFilterThreshold in preferences panel of Cytoscape (Edit-->Preferences-->Properties). ==== Search ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Type a search term in the "Search" field in the Toolbar. For example, search for the ID of one of the nodes in the network. ''Expected Results'' 1. If you searched for a node that is in the currently loaded network, the node will become highlighted. File Menu'''''Mike''''' File -> New through File -> Save As ==== File -> New -> Session ==== ''Procedure'' 1. Start Cytoscape. 1. Click File -> New -> Session 1. Load a network. 1. Click File -> New -> Session 1. Click yes. 1. Repeat, Click no. ''Expected Results'' 1. Nothing should happen because no networks have been loaded, there is no session yet. 1. You should be prompted with a dialog that reminds you that your current session will be lost. 1. If you click yes, you should get a new session with no networks in the network manager. 1. When you click no, you should see your existing session without any changes. ==== File -> New -> Network -> Empty Network ==== ''Procedure'' 1. Start Cytoscape. 1. Click File -> New -> Network -> Empty Network ''Expected Results'' 1. An empty network and view should be created. The Control Panel should be changed to the Editor Tab. ==== File -> New -> Network -> Construct network using cPath... ==== ''Procedure'' 1. Start Cytoscape. 1. Click File -> New -> Network -> Construct network using cPath... 1. Type the example "p53" into the cPath dialog. 1. Change the species drop-down menu to "Homo Sapiens" 1. Click Help then close the Help dialog. 1. Click About the close the About dialog. 1. Click Search. 1. Click the "X" in the dialog frame to close the cPath dialog. ''Expected Results'' 1. The cPath dialog should appear. 1. Another dialog should be displayed with text describing the features of the cPath dialog. 1. Another dialog should be displayed with text describing the authors of the software. 1. A network should be loaded with more than one node. 1. The dialog should close. ==== File -> New -> Network -> Clone current network ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Lay the network out in something other than a grid. 1. Change the visual style to something other than default. 1. Click File -> New -> Network -> Clone current network. ''Expected Results'' 1. You should see a new network with the same name as the previous network, but with the word " Copy" appended to it. This view should have the exact same node layout and visual style as the original network. ==== File -> New -> Network -> From selected nodes, all edges ==== ''Procedure'' 1. Start Cytoscape. 1. Load Network. 1. Make sure that NO nodes or edges are selected (i.e. click on the view somewhere other than on a node or edge). 1. Click File -> New -> Network -> From selected nodes, all edges. 1. Select some nodes and edges in the view. 1. Click File -> New -> Network -> From selected nodes, all edges. ''Expected Results'' 1. You shouldn't be able to click this option because it should be grayed out. This is because no nodes or edges are currently selected. 1. A new network and view should be created. The nodes should have the same layout and visual styles as the parent network. ==== File -> New -> Network -> From selected nodes, selected edges ==== ''Procedure'' 1. Start Cytoscape. 1. Load Network. 1. Make sure that NO nodes or edges are selected (i.e. click on the view somewhere other than on a node or edge). 1. Click File -> New -> Network -> From selected nodes, selected edges. 1. Click Select -> Mouse Drag Selects -> Nodes Only. 1. Select some nodes in the view. 1. Click File -> New -> Network -> From selected nodes, selected edges. ''Expected Results'' 1. You shouldn't be able to click this option because it should be grayed out. This is because no nodes or edges are currently selected. 1. A new network and view should be created. This network should only include the selected nodes and no edges. This network will be laid out as in the original network including the visual style. === Edit Menu === ==== Create View ==== ''Procedure'' 1. Start Cytoscape 1. Load BINDhuman.sif (or any other large (>10,000 node) network that doesn't automatically create a view) 1. Click Edit->Create View ''Expected Results'' 1. Verify that a task dialog pops-up indicating that the create view task is underway. 1. Verify that a view was created for the network. ''Procedure'' 1. Start Cytoscape 1. Load BINDhuman.sif (or any other large (>10,000 node) network that doesn't automatically create a view) 1. Click Edit->Preferences->Properties 1. Modify the ''secondaryViewThreshold'' entry and set the value to a relatively small number, say 300. 1. Click OK to close the preferences dialog. 1. Click Edit->Create View 1. Click "No" on the dialog asking if you'd still like to proceed. 1. Click Edit->Create View 1. Click "Yes" on the dialog asking if you'd still like to proceed. ''Expected Results'' 1. Verify that after you select "No" that no view is created. 1. Verify that after you select "Yes" that a task dialog pops-up indicating that the create view task is underway. 1. Verify that a view was created for the network. === View Menu === ==== View Control/Results Panel ==== ''Procedure'' 1. Start Cytoscape. 1. Click View -> Hide control panel 1. Click View -> Show results panel 1. Click View -> Show control panel 1. Click View -> Hide results panel ''Expected Results'' 1. The control panel; the left panel on the screen, should disappear. The network in the networkpanel adapts by centering in the panel 1. The results panel; empty grey panel should appear to the right (fills half the screen? is not intended behavior; Piet) 1. The control panel reappears with original size 1. The original situation is restored ==== View Data Panel (Attribute Browser) ==== ''Procedure'' 1. Start Cytoscape and load session file with several attributes 1. Click ''Select Attributes'' icon and select attributes from the popup list 1. Select several nodes 1. In the data panel select a cells by clicking (w/shift or ctl for multiple selection) 1. Swap columns and select nodes again 1. Click on ''Create new attribute'' icon and select ''String Attribute''. Then type name of the new attribute 1. Click ''Attribute Batch Editor'' icon on the right. Then select ''Set'' and the new attribute name created in the last step. Type any word and click ''Go'' 1. Click ''Delete attributes...'' icon and select one or more attributes. Then press ''Delete'' 1. Click View -> Hide data panel 1. Click View -> Show data panel ''Expected Results'' 1. After selecting attributes from list, they will be shown as column names 1. After selecting nodes they turn yellow 1. After selecting cells in the attribute browser, the corresponding node colors green 1. After swapping and selecting nodes again, the column order should remain the same 1. New attributes should be shown on the table (in the last column) 1. New values should be assigned to the selected attribute name column 1. After deletion, attributes should be removed from table AND attribute list 1. After clicking ->Hide data panel, the lower panel disappears and the graph zooms out to fill the complete larger network panel 1. After clicking ->Show data panel, the datapanel reappears, including data corresponding to the selected nodes; the graph fills the smaller networkpanel === Select Menu === ==== Mouse drag selects ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Click Select->Mouse drag selects 1. Left click mouse on network screen, while keeping pressed draw rectangle around a set of nodes and edges 1. Press CTRL+SHIFT+E and repeat selection 1. Click Select->Mouse drag selects->Nodes Only ''Expected Results'' 1. After clicking Select->Mouse drag selects, verify that Nodes and Edges is ticked 1. After drawing select rectangle nodes and edges are selected 1. After pressing CTRL+SHIFT+E selected nodes and edges are deselected and in subsequent selection with mouse, only edges are selected 1. After Select->Mouse drag selects->Nodes Only, selected edges are deselected and in subsequent selection with mouse, only nodes are selected ==== Nodes ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Select a subset of nodes and edges by mouse dragging 1. Click Select->Nodes->Invert node selection 1. Press CTRL+H 1. Click Select->Nodes->Show all nodes 1. Click Select->Mouse drag selects->Edges Only 1. Select a subset of edges only by mouse dragging 1. Press CTRL+A 1. Click Select->Nodes->Deselect all nodes 1. Click Select->Nodes->Nodes connected by selected edges 1. Press CTRL+6 1. Load galFiltered.gml from testData directory 1. Click Select->Nodes->By name... 1. In the textbox type: yh* 1. Copy and paste the following text in a texteditor and save somewhere as file YHR115C YHR174W YHR141C 1. Click Select->Nodes->From file... 1. In the dialog box select the file saved above ''Expected Results'' 1. After selection a subset of nodes and edges is selected 1. After Select->Nodes->Invert node selection, all other nodes are selected, current selection deselected, edges stay selected 1. After CTRL+H selected nodes and their connecting edges disappear 1. After Select->Nodes->Show all nodes, all nodes and edges reappear 1. After Selecting edges only and pressing CTRL+A all nodes are selected; the selected edges stay selected 1. After clicking Select->Nodes->Deselect all nodes are deselected; the selected edges stay selected 1. After clicking Select->Nodes->Nodes connected by selected edges, the nodes connected by selected edges are selected 1. After pressing CTRL+6, the node selection is expanded with the first neighbours; their connecting edges are not selected 1. After loading the galFiltered.gml and selecting nodes by name yh* verify that 13 nodes starting with YH are selected 1. After loading the file verify that YHR115C, YHR174W and YHR141C are selected ==== Edges ==== ''Procedure'' 1. Start Cytoscape. 1. Load a network. 1. Select a subset of nodes and edges by mouse dragging 1. Click Select->Edges->Invert edge selection 1. Press ALT+H 1. Drag the group of selected nodes for some distance over the screen 1. Click Select->Edges->Show all edges 1. Click Select->Mouse drag selects->Nodes Only 1. Select a subset of node only by mouse dragging 1. Press ALT+A 1. Click Select->Edges->Deselect all edges 1. Press ALT+E 1. Click Select->Mouse drag selects->Nodes and Edges 1. Click Layout->yfiles->Hierarchic 1. Select a subset of edges including some angled edges 1. Click Select->Edges->Smooth selected edges 1. Click Select->Edges->Straighten selected edges ''Expected Results'' 1. After selection a subset of nodes and edges is selected 1. After Select->Edges->Invert edge selection, all other edges are selected, current selection deselected, nodes stay selected 1. After ALT+H selected edges disappear, the nodes stay visible 1. After Select->Nodes->Show all nodes, all edges reappear correctly drawn wrt the new position of the nodes 1. After selecting a subset of nodes and pressing ALT+A, all edges are selected, subset of nodes stays selected 1. Click Select->Edges->Deselect only deselects edges 1. Pressing ALT+E selects all edges connecting to the node selection 1. After applying the hierarchic layout to (eg galFiltered.gml) the network edges with angles are present 1. Selecting these angled edges and applying Smooth selected edges, results in a curved edge; straightening these returns them to their angled state === Layout Menu === ==== Stopping yFiles Organic ==== ''Procedure'' 1. Start Cytoscape 1. Load a large network, e.g. BINDyeast.sif (found in the sampleData directory). 1. Create a view for the network. 1. Click Layout -> yFiles -> Organic ''Expected Results'' 1. Verify that the task dialog that pops up contains a ''Cancel'' button. 1. Verify that you can click on the ''Cancel'' button and that the layout actually stops. === Plugins Menu === ==== Plugins -> Manage Plugins -> Install ==== ''Procedure'' 1. Start Cytoscape 1. Click Plugins -> Manage Plugins. 1. In the Manage Plugins window, expand the "Currently Installed" folder by double-clicking the folder icon, then expand the Core folder by clicking on the arrow symbol next to it. 1. Select any of the plugins listed by clicking on it. 1. Expand the "Available for Install" folder. 1. Select any plugin that is not already installed. Click the Install button. ''Expected Results '' 1. The Manage Plugins window should open with folder "Currently Installed" and "Available for Install" in the left panel. The first time Manage Plugins is selected in an instance of Cytoscape, a connection status window should open before the Manage Plugins window appears. 1. Under "Currently Installed" and "Available for Install" there should be subfolders listing individual plugins. 1. When clicking on a plugin, information about the plugin should appear in the right panel. 1. During plugin installation, you should get an installation progress window. When installation is complete, a message in red is displayed under the left panel stating that the installation is complete. 1. The newly installed plugin should be visible under "Currently Installed" folder. ==== Plugins -> Manage Plugins -> Change Download Site ==== ''Procedure'' 1. In the Plugin Manager window, click the "Change Download Site" button.''' ''' 1. In the drop-down menu, change the download site to Test and then click the Ok button. 1. In the Manage Plugin main window, click the "Change Download Site" button again. 1. In the Plugin Download Sites window, click the "Add Site" button. 1. Click the "Add" button. 1. Type in a name and a URL (any) and click OK. 1. Click OK to exit the Bookmark Manager. Click OK in the Plugin Download Sites window to get back to the Plugin Manager main window. Click the Close button to exit the Plugin Manager and close Cytoscape. ''Expected Results'' 1. A Plugin Download Sites window will appear with a drop-down menu for selecting download site. 1. A progress bar should appear. When the download site has been switched, you should see a different folder structure under Available for Install. 1. When selecting the Add Site button in the Plugin Download Sites window, a Bookmark manager window will appear. 1. When clicking Add in the Bookmark manager, an Add new bookmark window will appear. 1. After adding a new site, the new download site will appear in the list of Bookmarks. ==== Plugins -> Update Plugins ==== ''Procedure'' 1. Start Cytoscape 1. Click Plugins -> Update Plugins ''Expected Results'' 1. A progress window will appear informing you of the status of updates. If no updates are available for installed plugins, a message will appear telling you that no updates where available. ==== Plugins -> Merge networks ==== ''Procedure'' 1. Start Cytoscape 1. Load two or more networks. 1. Click Plugins -> Merge networks. 1. To select networks, click on the network and then click the right arrow. Select two or more networks from the list. 1. Select an operation in the Operation drop-down menu. 1. Click OK to merge the networks. ''Expected Results'' 1. A Merge Networks dialog should appear with the loaded networks listed under Available Networks. 1. A new network view will open with the results of the merge. ''Procedure'' 1. Start Cytoscape 1. Load two networks. 1. In one of the network select a few nodes. 1 Change the visual style of each network so that their visual styles are different. 1. Click Select->Nodes->Hide node selection 1. Click Plugins -> Merge networks. 1. To select networks, click on the network and then click the right arrow. Select two or more networks from the list including the network with the hidden nodes. 1. Choose the Union set operation. 1. Click OK ''Expected Results'' 1. Ensure that no exceptions are thrown. 1. Verify that the new network has the visual style of the first network in the list of networks to be unioned. === Help Menu === === Control Panel - Network === === Control Panel - VizMapper === ==== Test 1: Global Commands ==== ''Procedure'' 1. Switch Visual Style from the combo box 1. All of the following commands are under Options icon (click '''''Options...'''''): 1. Select ''Create new Visual Style...'' and type new Visual Style name 1. Select ''Delete Visual Style'' 1. Select ''Rename Visual Style'' and type new name 1. Select ''Copy existing Visual Style'' and type new name. Change background clolor from Default Editor and switch back to the original style 1. Select ''Create legend from current Visual Style''. Select '''eps''' as export type and click ''Export'' ''Expected Results'' 1. The selected Visual Style should be applied on the current network view 1. Option commands should behave like the following: 1. New visual style should be created. The new style has only name mapping (ID) 1. Currently selected visual style will be removed from the combo box and default style will be applied. If the selected style is ''default'' error message will be appear on the window. 1. The new name appear on the combo box 1. Copied visual tyle should appear in the combo box. Once one of the properties has been changed, the two style should look different 1. The generated vector image file should be readable with Acrobat ==== Test 2: Default View Editor ==== ==== Test 3: Individual Mapping Editors ==== ==== Test 4: Right-Click Menu ==== ''Procedure'' 1. Select '''Lock Node Width/Height''' and then select again to switch back to the original value. ''Expected Results'' 1. If unlocked, '''Node Width''' and '''Node Height''' will be displayed on the list. Otherwise, only '''Node Size''' is shown. Also, Default view should be updated accordingly. ===== Passthrough Mapper ===== ===== Discrete Mapper ===== ===== Continuous Mapper ===== === Control Panel - Editor === There are multiple tests for the Cytoscape Editor: ==== Control Panel - Editor -> add a simple interaction ==== ''Procedure'' 1. Click File -> New -> Network -> Empty Network to bring up a new network and the editor palette. 1. click on a node in the editor Palette and drag/drop it onto the network view to form ''node0''. 1. repeat step 2 to add a second node to the network view (''node1''). 1. click on an edge in the editor palette, drag/drop it onto onto ''node0''. 1. move the mouse to drag the rubberband line from ''node0'' to ''node1''. 1. release mouse when over ''node1''. ''Expected Results'' 1. You should see a network of two nodes, ''node0'' and ''node1'', connected by a single edge. ==== Control Panel - Editor -> keyboard accelerators ==== ''Procedure'' 1. Click File -> New -> Network -> Empty Network to bring up a new network and the editor palette. 1. control-click on an empty space on the canvas to add a node to the network view. 1. repeat step 2 to add a second node to the network view 1. control click on one of the two added nodes to begin an edge. This will be ''source node.'' 1. move the mouse to drag the rubberband line from ''source node ''to the other node (''target node).'' 1. release mouse when over ''target node.'' ''Expected Results'' 1. You should see a network of two nodes, ''source node ''and ''target node'', connected by a single edge. ==== Control Panel - Editor -> connect selected nodes ==== ''Procedure'' 1. Click File -> New -> Network -> Empty Network to bring up a new network and the editor palette. 1. control-click on an empty space on the canvas to add a node to the network view. 1. repeat step 2 several times to add other nodes to the network view''' ''' 1. select all the nodes by clicking on an empty space on the canvas, then dragging a rubberband rectangle around all the nodes (or use Control-A keyboard accelerator) 1. select Edit -> Connect Selected Nodes menu item. ''Expected Results'' 1. You should see a clique, i.e. there is an edge connecting every pair of nodes ==== Control Panel - Editor -> change visual style ==== ''Procedure'' 1. Select Vizmapper(tm) tab in Control Panel. 1. select a different visual style by choosing it from combo box under Current Visual Style. 1. select Editor tab in Contol Panel''' ''' ''Expected Results'' 1. You should see a different set of node shapes and edge lines on the Editor palette. === Control Panel - Editor -> delete nodes and edges === ''Procedure'' 1. Click File -> New -> Network -> Empty Network to bring up a new network and the editor palette. 1. control-click on an empty space on the canvas to add a node to the network view. 1. repeat step 2 several times to add other nodes to the network view 1. select all the nodes by clicking on an empty space on the canvas, then dragging a rubberband rectangle around all the nodes (or use Control-A keyboard accelerator) 1. select Edit -> Connect Selected Nodes menu item. 1. Select a subset of nodes and edges by dragging a rubberband rectangle around several nodes and edges 1. Select Edit -> Delete Selected Nodes and Edges menu item. ''Expected Results'' 1. You should see the selected set of nodes and edges disappear. Also, any edges that connect deleted nodes to non-deleted nodes will also disappear. === Control Panel - Filters === === Data Panel - Node, Edge, and Attribute Browser === ==== View Attributes ==== ''Procedure'' 1. Start cytoscape. 1. Load the galFiltered.cys session file. 1. Using the mouse, select a few nodes in the view. 1. Click on the top left button in the '''Data Panel''' 1. Select one or more attributes from the list. ''Expected Results'' 1. You should see values listed in a spreadsheet like table. 1. When you hover your mouse over a cell with data in it you should see the data presented in a nice tooltip. 1. When you hover your mouse over a cell with no data in it you should see the previous tooltip go away and no new tooltip should be presented. == Workflow Testing == ''The goal of this section is to verify that the various [[Workflows|workflows]] described for Cytoscape do actually work. In addition to the workflows described, we will also verify that each [[Presentations|tutorial]] also works. The output of these tests will be different than simply a checklist. The goal is to capture the steps in the workflow in a screencapture movie. The movie should capture the screen as a user follows each step in the workflow or tutorial. Audio commentary is preferred since this allows to both see and hear the steps being followed. '' === Workflow 1: Annotating a Network with Web Services === ==== Requirments ==== This workflow needs the following plugins: * Biomart Client * Biomart Client UI ===== Test Procedure ===== (Under construction) 1. Import galFiltered.sif. This is a yeast network with Ensembl Gene ID as node identifier. 1. '''''File-->Import-->Attributes from Biomart'''''. Task Monitor appears and the plugin builds GUI based on the entries returned from Biomart. 1. Select '''ENSEMBL 48 GENES (SANGER) - Saccharomyces cerevisiae genes (SGD 1.01)''' for '''''Data Source''''' 1. Make sure '''''Attribute''' is set to '''ID''' '' 1. Set '''''Data Type'''' to '''Ensembl Gene ID(s)''' '' 1. From the attribute list, select the following: * !EntrezGene ID * SGD * Unified !UniProt Accession 1. Press '''Import''''''' ''' 1. Go to Attribute Browser's menu bar and click Select Attributes''''''' icon and select newly imported attributes. Make sure most of the nodes are annotaed. 1. Go back to the Biomart Web Service window. Switch '''Data Source''''''' to '''ENSEMBL 48 HOMOLOGY (SANGER) - Homo sapiens (NCBI36)|Saccharomyces cerevisiae genes (SGD 1.01)|Orthologues'''. ''' 1. Select S. cer Ensembl Gene ID(s)''' for '''Data Type''''''' 1. From the annotation list, select the following: * H. sap ensembl gene ID * H. sap display label * H. sap homology peptide % ID 1. Press '''Import''''''' ''' 1. Check imported attributes in Attribute Browser.