Differences between revisions 1 and 3 (spanning 2 versions)
Revision 1 as of 2006-11-15 00:08:54
Size: 2978
Comment:
Revision 3 as of 2006-11-15 00:21:46
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

  1. Select two or more nodes
  2. 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
  3. Automatically view collapsed view of group with default label (editable)
  4. Be able to expand group as vertically stacked set of nodes by a very simple mechanism (e.g., click on a plus/minus icon)
    1. perhaps other restricted views of the children will be allowed:
      1. horizontal stack
      2. block (e.g., 2x2, 3x4)
      3. overlapping "clump" of nodes packed into a some defined circular area
  5. Be able to destroy group
  6. Be able to expand-all or collapse-all groups in a given network

Loading a Network with Paralog Groups

  1. 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.

Comments

PageComment2

groupAPI/UseCase_5A (last edited 2009-02-12 01:03:45 by localhost)

Funding for Cytoscape is provided by a federal grant from the U.S. National Institute of General Medical Sciences (NIGMS) of the Na tional Institutes of Health (NIH) under award number GM070743-01. Corporate funding is provided through a contract from Unilever PLC.

MoinMoin Appliance - Powered by TurnKey Linux