## These are wiki comments - leave them in so that people can see them when editing the page ## This template may be useful for documenting use cases ## Developed in response to a hackathon request for formalized, detailed use cases ## to help direct implementation proposals || '''Use Case Name''' : ../PathBranching || || '''For Feature''' : MIMEditor || || '''Editors''': DavidKane || ## EXAMPLE: ## Use Case Name: Representation of Protein Complex ## For Feature: Grouping Function ## Editors: Mr. Knowitall <> == Summary == ## Provide a one paragraph description of the use case User wants to compactly layout many contigency relationships for the same species == Step-by-Step User Action == ## Provide a step-by-step account of how the user would execute the use case. For example: (1) right click on node, (2) choose "expand" from context menu, (3) new view is created, etc... 1. User specifies a contigency relationship (e.g. ../ProcessStimulation, ../ShowInhibition) 1. User specifies a second contigency relationship of the same type with the same species origin 1. User joins the two relationships with a branch 1. User moves the branch point to a convenient location == Visual Aides == ## Provide attachments to images to illustrate the use case (screenshots, mock-ups, storyboards, etc) The following example has several branches, but the clearest are the several ../EnzymaticStimulation relationships from ATM. Instead of four edges going from ATM to the four species it stimulates, there is one edge that branches three times. {{attachment:pathbranching1_061120_dwk.png}} == Requirements for Cytoscape == ## List the components/functions already in Cytoscape that are relevant to the use case and possible implementations (e.g., "current context menus can be used accomplish step 2 above") ## Also list components/functions that are needed in Cytoscape to execute the use case (e.g., "cytoscape needs to allow for multiple views of the same network for this to work") TBD == Importance == ## Describe whether this use case is critical and how frequently users would come across it. Describe common work flows that might involve the use case (e.g., "this use case comes up regularly, on a weekly basis, whenever we want to analyze our protein superfamily networks"). This important for keeping the diagrams from becoming too cluttered. == Other Examples == ## List other applications or relevant examples outside of Cytoscape that provide some or all of the desired functionality (e.g., "You can do this using the group function in PowerPoint"). == Comments == Shared ../MimEditorUseCaseComments BioPax representation TBD ---- AllanKuchinsky - 2007-01-23 04:39:32   This is similar to the first neighbors functionality in Cytoscape (Select -> Mouse Drag Selects -> Nodes -> First Neighbors of Selected Nodes).  Should be straightforward to implement.