← Revision 1 as of 2006-11-15 00:08:54 →
Size: 2978
Comment:
|
Size: 3917
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 7: | Line 7: |
|| '''Use Case Name''' : ... || || '''For Feature''' : ... || || '''Editors''': ... || |
|| '''Use Case Name''' : Paralogs || || '''For Feature''' : Groups || || '''Editors''': Kristina Hanspers || |
Line 16: | Line 16: |
[[TableOfContents([2])]] | [[TableOfContents([2])]] |
Line 19: | Line 19: |
## To represent two or more protein paralogs that can perform the same step in a pathway, we would like to group these. The set of proteins represent a logical OR, where either one of them alone can perform the reaction in question. To reduce complexity and enhance readability, it would be desirable to have these exhibit the properties of a group, in terms of collapsing etc, especially if there are many occurances of paralogs in one pathway. |
## Provide a one paragraph description of the use case To represent two or more protein paralogs that can perform the same step in a pathway, we would like to group these. The set of proteins represent a logical OR, where either one of them alone can perform the reaction in question. To reduce complexity and enhance readability, it would be desirable to have these exhibit the properties of a group, in terms of collapsing etc, especially if there are many occurances of paralogs in one pathway. |
Line 22: | Line 23: |
## Creating a New Group of Paralogs |
## 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... Creating a New Group of Paralogs |
Line 28: | Line 30: |
a. perhaps other restricted views of the children will be allowed: i. horizontal stack i. block (e.g., 2x2, 3x4) i. overlapping "clump" of nodes packed into a some defined circular area |
a. perhaps other restricted views of the children will be allowed: i. horizontal stack i. block (e.g., 2x2, 3x4) i. overlapping "clump" of nodes packed into a some defined circular area |
Line 35: | Line 37: |
## Loading a Network with Paralog Groups | Loading a Network with Paralog Groups |
Line 39: | Line 41: |
## coming soon... |
## Provide attachments to images to illustrate the use case (screenshots, mock-ups, storyboards, etc) coming soon... |
Line 42: | Line 45: |
## 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., |
|
Line 50: | Line 54: |
## Paralogs appear on many pathways, and being able to group them is important for readability of complex pathways. |
## Describe whether this use case is critical and how frequently users would come across it. Paralogs appear on many pathways, and being able to group them is important for readability of complex pathways. |
Line 53: | Line 58: |
## 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"). |
Use Case Name : Paralogs |
For Feature : Groups |
Editors: Kristina Hanspers |
Summary
To represent two or more protein paralogs that can perform the same step in a pathway, we would like to group these. The set of proteins represent a logical OR, where either one of them alone can perform the reaction in question. To reduce complexity and enhance readability, it would be desirable to have these exhibit the properties of a group, in terms of collapsing etc, especially if there are many occurances of paralogs in one pathway.
Step-by-Step User Action
Creating a New Group of Paralogs
- Select two or more nodes
- Choose "Group Paralogs" or just “Group” (don’t know how specific this needs to be for the user) from a context menu, main menu or toolbar
- Automatically view collapsed view of group with default label (editable)
- Be able to expand group as vertically stacked set of nodes by a very simple mechanism (e.g., click on a plus/minus icon)
- perhaps other restricted views of the children will be allowed:
- horizontal stack
- block (e.g., 2x2, 3x4)
- overlapping "clump" of nodes packed into a some defined circular area
- perhaps other restricted views of the children will be allowed:
- Be able to destroy group
- Be able to expand-all or collapse-all groups in a given network
Loading a Network with Paralog Groups
- Same as 3-6 above
Visual Aides
coming soon...
Requirements for Cytoscape
- The Group API can handle this one in terms of create, expand, collapse and destroy
- A simple GUI for create, expand, collapse and destroy should be sufficient. Specific semantics for paralogs may not be necessary.
- Need to add simple layout/alignment algorithms for stacking children vertically in expanded view
- Need to support the storage of groups in a pathway file format. xGMML and GenMAPP's GPML?
Importance
Paralogs appear on many pathways, and being able to group them is important for readability of complex pathways.
Other Examples
- Simple, intuitive examples of expand and collapse can be found in directory tools/explorers that let you click on an icon (e.g., a triangle or plus/minus) to expand and collapse the view.
- Illustrator and other such programs have a grouping function that mimics the restriction on children once a group is formed. You cannot move the children relative to each other, for example. If you want to treat them independently, you have to ungroup.