Differences between revisions 2 and 3
Revision 2 as of 2006-03-07 20:54:02
Size: 3131
Editor: GaryBader
Comment: Better to use wiki links if possible rather than a URL (URL may change)
Revision 3 as of 2006-03-14 03:09:56
Size: 4219
Editor: gamay
Comment:
Deletions are marked like this. Additions are marked like this.
Line 38: Line 38:
 * Have a default vizmap.props file that is included in and loaded from cytoscape.jar.
 * Save all changes to vizmap.props in the project (.cys) file.
 * Have the ability to import/export vizmap.props through menu items, command line options, etc. for the rare instances that saving the properties in the .cys file isn't sufficient ( e.g. when you want to share a set of visual properties you came up with).
=== Loading ===
The current scheme for loading vizmap.props at startup is as follows. This is also the order of precedence, so the most recently loaded vizmap.props file will be the current one.
 * read the vizmap.props in cytoscape.jar - this file must exist.
 * read $HOME/.cytoscape/vizmaps.props - if it exists.
 * read the vizmap.props file specified on the command line - if it exists.
Either of the following actions will overwrite (in memory) the current vizmap.props:
 * read the vizmap.props file saved in the cytoscape session file - if a session file is loaded.
 * read the vizmap.props file specified in the import dialog - if so requested.
=== Saving ===
 * When a session is closed, the vizmap.props file is saved with the session file.
 * If the user clicks the "Make Current Visual Style Default" button in the Preference Dialog, the current vizmap.props will be written to $HOME/.cytoscape/vizmaps.props.
 * '''The vizmap.props file will be saved at NO other time!!!'''
[[BR]]
=== No Longer Under Consideration or On Hold ===
Line 42: Line 53:
[[BR]]    We're allowing for the default vizmap.props to change if the user desires. This adds a complication and the potential for confusion if the user expects $HOME/.cytoscape to contain their most recent vizmap.props and it doesn't. However, we feel that because the vizmap.props is '''always''' saved in the session file, this is less of a concern. No one should lose their visual styles assuming they save their session.
Line 44: Line 55:
   Currently on hold.

RFC Name : ...

Editor(s): ...

TableOfContents([2])

About this document

This is an official Request for Comment (RFC) for Fixing the loading and saving of the vizmap.props file

For details on RFCs in general, check out the [http://www.answers.com/main/ntquery?method=4&dsid=2222&dekey=Request+for+Comments&gwp=8&curtab=2222_1&linktext=Request%20for%20Comments Wikipedia Entry: Request for Comments (RFCs)]

Status

Open for public comment

How to Comment

To view/add comments, click on any of 'Comment' links below. By adding your ideas to the Wiki directly, we can more easily organize everyone's ideas, and keep clear records. Be sure to include today's date and your name for each comment. Here is an example to get things started: ["/Comment"].

Try to keep your comments as concrete and constructive as possible. For example, if you find a part of the RFC makes no sense, please say so, but don't stop there. Take the extra step and propose alternatives.

Introduction

The vizmap.props file is currently loaded from at least 2 different default locations. One is the cytoscape installation directory and the other is the users .cytoscape directory in their home directory. Figuring out these locations, learning when files get saved to certain locations, and when files get loaded from certain locations is difficult for users.

This document is an attempt to develop a new scheme for loading and saving vizmap.props files.

Biological Questions / Use Cases

  • Users want to save a set of visual properties they have spent many hours developing.
  • Users want to load the visual properties they spent yesterday creating.
  • Users want the same visual properties to be applied to the same network.

Proposal

Loading

The current scheme for loading vizmap.props at startup is as follows. This is also the order of precedence, so the most recently loaded vizmap.props file will be the current one.

  • read the vizmap.props in cytoscape.jar - this file must exist.
  • read $HOME/.cytoscape/vizmaps.props - if it exists.
  • read the vizmap.props file specified on the command line - if it exists.

Either of the following actions will overwrite (in memory) the current vizmap.props:

  • read the vizmap.props file saved in the cytoscape session file - if a session file is loaded.
  • read the vizmap.props file specified in the import dialog - if so requested.

Saving

  • When a session is closed, the vizmap.props file is saved with the session file.
  • If the user clicks the "Make Current Visual Style Default" button in the Preference Dialog, the current vizmap.props will be written to $HOME/.cytoscape/vizmaps.props.
  • The vizmap.props file will be saved at NO other time!!!

BR

No Longer Under Consideration or On Hold

  • Do away with all of the existing default handling and placement of vizmap.props files. This means no saving in $HOME, no saving in the cytoscape install directory, and no loading from places that a user doesn't explicitly request.

    • We're allowing for the default vizmap.props to change if the user desires. This adds a complication and the potential for confusion if the user expects $HOME/.cytoscape to contain their most recent vizmap.props and it doesn't. However, we feel that because the vizmap.props is always saved in the session file, this is less of a concern. No one should lose their visual styles assuming they save their session.

  • Generalize the loading of vizmap.props to loading parameters and preferences. See ["generic preferences system"] for details.
    • Currently on hold.

Requirements

  • Support loading of vizmap.props from webstart bundles.

Backward Compatibility

In the proposal above, backwards compatibility is achieved by the user importing his or her favorite vizmap.props file.

Implementation Plan

  • ["/Implementation Plan"]

VizMapPropsRFC (last edited 2009-02-12 01:03:34 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