Page History

Case Study: Adding "-> Logbook..." to CSS Data Browser

...

1. Decide on the level of integration
   • I decided to use the "very low level" of integration, because that seems like the easiest way to work with CSS.
   • More info: http://css.desy.de/content/e760/e761/index_eng.html^{Image Modified}

...

1. Check out the CSS source code

   ...

   1. 1. Install Mercurial locally
         • Download Mercurial source code from http://mercurial.selenic.com/release/mercurial-1.6.4.tar.gz^{Image Modified}
         • Type "make local" in the top directory
         • Install the MercurialEclipse plugin, too, but don't use it as such need

   ...

   1. 1. • usage tips from Kay & Co.
      2. Clone the CSS repository
         • Several available: http://sourceforge.net/apps/trac/cs-studio/wiki/SourceRepository^{Image Modified}
         • Use 'read-only' repository => http://cs-studio.hg.sourceforge.net:8000/hgroot/cs-studio/cs-studio^{Image Modified} (no account/password)
      3. Increase JVM memory for Eclipse
         • Edit eclipse.ini in $ECLIPSE_HOME (1024 MB is what I ended up with)
      4. Import the necessary CSS plugins as Eclipse projects
         • The minimum list of plugins to develop with DataBrowser need clarification from Kay & Co.
           Image Modified
   1. Checkout the HLA

   ...

   1. source code (from CVS)
   1. Create the edu.stanford.slac.save2logbook plugin

   ...

   1. • Copy the HLA Save2Logbook source to this plugin and configure

   ...

   1. • for other plugins to use

   ...

   1. • it
   1. Add to the DataBrowser plugin the dependency

   ...

   1. on edu.stanford.slac.save2logbook

   ...

   1. • Eclipse bug: If plugins panel is empty, start typing the plugin name

   ...

   1. Implement the new features in DataBrowser and Save2Logbook plugins
      • Add JFace Button, called '-> Logbook...'
      • Add JFace ActionListener to generate an Eclipse (Graphics) image
      • Add a method in Save2Logbook that saves an Eclipse image as a JPEG file
   1. Test the new features by running DataBrowser as an Eclipse application
   1. Create a SLAC DataBrowser product configuration
      • Select CSS Data Browser as the application
      • Modify CSS splash
   1. Export SLAC DataBrowser to some local directory and distribute it from there
   1. When launching SLAC DataBrowser for the first time, configure EPICS and DataBrowser EPICS preferences

   Major To-Dos

   • Headless build
   • "Workspace in use" issues

   ...