Mini-Retreat One

• September 12-13, 2008

• [http://www.ucsd.edu/maps/index.jsp?mapid=601&wid=601&iws=false&cat=&t=m&z=15&opacity=50&ll=32.88178563936398,-117.23437786102295 "Department of Bioengineering"] (Powell-Focht Bioengineering Hall), UC San Diego, Room 291

• Mike's cell: 858-228-7242
• Mike's office: 858-822-4756

Topics for Discussion

• Progress on merging the new CyNetwork and CyAttributes model with the 3.0 branch.

  • CyAttributes API changes based on retreat discussions (Trey's references [:CytoscapeRetreat2008/Design:notes]), CyDataTable

• Discussion of how Groups will fit in to the model package.

• Discussion of how HyperEdges will be handled.

• Progress on ViewModel API?

• Division of Labor - figure out what tasks can be separated out amongst other groups.

Goal

• Get the application and at least one core plugin working with the new CyNetwork and CyAttribute models.

Meeting Notes

• Gary opinion, Sep8 - Re: groups. Groups definitely belong in the model, but they should be kept separate from the core network model. There should be a CyGroups API similar to the one that exists that keeps track of all group information. Algorithms that work on simple graphs (most of the existing Cytoscape and plugin code) will not need to know about groups and those that need groups will be able to access the information using the CyGroups API. Group views on the other hand will likely need a lot of custom node shape functionality in the view layer. This is how Hyperedges should work as well.

• Piet opinion, Sep9 - Re: goal. Isn't division of coding-labour one of the goals of these mini-retreats also?
• Scooter, Sep 11 - I'm starting to get concerned that people might be spending too much time moving plugins over the Cy3 trunk without knowing how much the API is still in flux. We still haven't even talked about the View API much and a lot of plugins leverage various view features extensively. I think we should talk about exactly how people should be viewing Cy3 at this stage. We're going to have a lot of people really upset with us if they do a lot of work that has to be completely redone. On the other hand, we want people to give us input about what's missing in the tree, so some work is warranted.

• Discussion: When do we extend CyNetwork vs. use well-known attributes? In the case of compound networks (metaNodes) we decided that they required additional semantics, so CyNetwork was extended. In the case of HyperGraphs, we're going to use nodes in any case, so we are not going to change the semantics. Therefore, a connector node will be identified by the NODE_TYPE_ATTR attribute.

Goal

Goal is to discuss these core layers and target an API for this core to allow more rapid, distributed porting and development

Minimal set of core layers to focus on:

• Data (CyAttributes, CyDataTable)

• Network 

• ViewModel

• PresentationView (Renderer)

• Command (Tasks, Tunables)
• I/O
• Event Handling

CyDataTable

public interface CyDataTable {

• public boolean isPublic(); public String getName(); /**
  • /

  public Map<String,Class<?>> getColumnTypeMap(); /**

  • @param attributeName The name identifying the attribute.
  • /
  public void deleteColumn(String attributeName); /**
  • @param attributeName The name identifying the column.
  • @param type The type associated with the column.
  • @param unique Whether the entries in the column are unique.
  • /

  public <T> void createColumn(String attributeName, Class<? extends T> type, boolean unique);

  public List<String> getUniqueColumns();

  public <T> List<? extends T> getColumnValues(String columnName, Class<? extends T> type);

  public CyRow getRow(long index);

  public CyRow addRow(); public static final String PRIMARY_KEY = "AID";

• CyAttributes replaced by CyRow

• CyFunction - beginnings of formula support

CyMetaNode

Tackled CyGroups: Selection/Filters/NamedSelection(Groups)

• should selection be an attribute?

• Scooter -> selection model in cytoscape 3.0 should be tied to vizmapper, allowing flexible visual indication of selection (inspired by Gang Su's UI work with GLay)

• How CyGroups works...

• Should we go all the way and shoot for a Compound Graph

• Need a CyRootNetwork and CyNetwork

  • a CyNode can contain a CyNetwork

• the CyRootNetwork contains nodes, obviously, but cannot be contained itself

• default behaviour getCurrentNetwork.getNodes() returns the nodes currently viewed based on the state of the collection of CyNetworks

• advanced usage allows you to ask if current CyNetwork is the root, if yes, then type it as such, then call getAllNodes()

• subclassing and extending an interface follows from the intention to change the semantics. If the semantics of a class are changed by new methods, then you should extend/subclass; if the semantics are unchanged, the same class should be used.

HyperEdge

• distinguish between "simple" CyNetworks and "complex" CyNetworks

  • "complex" gets you both the MetaNode and HyperEdge

• CyConnnectorNode handled by NodeType namespace

• NodeType attribute namespace to handle connector (not another subclassing of the interface)

• CyDataTables will getSUID and get/setTitle. There are specific semantics in Network. When a data table is bound to a network the title is then mapped to a namespace (per network): SUID and namespace are fixed, title is not.

• Per "complex" networks, there is one DataTable for each CyRootNetwork

ViewModel / Presentation Requirements

• Extensibility is key.

• What is the granularity of extensibility? Should it be Node and Edges (i.e. NodeRenderer, EdgeRender), Network (just one renderer for the whole shebang), or VisualProperty (one renderer per visual property)?

• Where are VisualProperties defined? Are they a function of a renderer or are they intrinsic to the ViewModel. Should there be a third class (e.g. VisualPropertyProvider)?

  • Who handles serialization and de-serialization?

  • Should there be default or "essential" set of VisualProperties?

  • How doe VisualProperties meaningful in one context (e.g. Paint in java) get translated into a different context where the concept isn't meaningful (e.g. there is no Paint in SVG)?

  • Does VisualPropertyProvider (assuming such a thing exists) have a user interface? How does the VizMapper provide a UI for a VisualProperty that it has never seen before? Presumably the VisualProperty will have some definition of the variable or variables that describe its range of flexibility. Is there a mechanism for the VisualPropertyProvider to provide handlers for setting unknown properties in the VizMapper. Can you provide new VizMapper editors?

• ViewModel must not depend on the Renderer. Cytoscape's data layers should be usable without a Renderer. Imagine a webservice.

• How to handle multiple layers of a presentation? Background/foreground images?

• VisualProperty needs to be able to describe how attributes (attribute types and editor types) can be mapped to this VisualProperty.

Plans and Decisions