RFC_Custom_Graphics_VizMapper

Status

3/9/2010 - KeiichiroOno: start working on actual design and implementation

Proposal

We would like to provide some mechanism for allowing users to specify custom graphic images that can be applied to a network using the VizMapper.

Background

The goal of this RFC is to explore ideas for bringing custom graphics out of the programmer-only domain and allow normal users to specify custom graphics for nodes using normal Cytoscape tools like the VizMapper.

Use Cases

• A user wants to draw expression values as histogram on nodes (see the pictures above)
• A user wants a node shape that we don't supply by default.

• A user wants some non-standard graphic to be applied on or around a node.

Implementation Plan

• The general idea is to create a new NODE_CUSTOM_GRAPHIC visual property that would allow users to map specific images to nodes.

• This visual property would behave the same as other discrete properties like node shape or line type. This implies that most of the existing VizMapper GUI widgets could be used with minimal modification.

• We would provide a new menu option that would allow users to load image files and make them accessible to the VizMapper.

• We would need to consider I/O issues related to Session saving and loading.

  • One thought is to make a Custom Graphic a new type of CyAttribute. The advantage is that we could use the existing I/O mechanisms and we also allow passthrough mappings to point to the image. However, that might not buy us much as we'd need to add support in MANY places. It also doesn't make much sense to have graphics attached to specific nodes from the outset.

Specific Ideas

• Images could be specified using URLs or local files. This implies we'd use the Bookmarks API and the normal FileUtil for loading images into Cytoscape.

• We would use the session plugin file saving mechanism for storing loaded images.
• Write all UI functionality (menu items, etc.) as a plugin. Only touch the core for adding new visual properties.
• Setting custom images would simply use the existing custom graphic API in Ding.

Project Management

Project Dependencies

• This depends on the CustomGraphic API present in !DNodeView, something we might want to expose in GINY instead.

Issues

• What sort of image types will we support? PNG and JPG should be easy, but what about vector graphics like PDF or SVG?
• Would we want to provide facilities for scaling or other affine transforms for manipulating the images once they're loaded?

• We might want a separate visual property for setting custom graphic position. If not then we might need to extend current discrete VizMapper widgets to allow use to choose North/South/East/West positioning. Either way, this might be messy given the current API.

• What about background images?
  • Can we provide a minimal API that allows users to set background images?

  • How would this integrate with the VizMapper?

Comments