WBDisplay Java Application
==========================

  The Java JAR file WBDISPLAY.JAR contains the application WBDisplay
  which can be used on Java 1.4 or newer platforms to generate
  spectrograms from the University of Iowa Analog Archive data files on
  this volume.

  The Java Runtime Environment (JRE) is freely available for common
  platforms from http://java.sun.com/.

  On most platforms the application can be started by opening a command
  console, changing directory to the SOFTWARE directory on the volume,
  and issuing the command:

    java -Xmx256m -jar WBDISPLAY.JAR

  The Java virtual machine will load the application and display a
  two-panel plot with a frequency-time spectrogram in the upper panel and
  a line plot in the lower panel showing a small sample of the original
  time-domain waveform.  The current application is file-oriented so it
  is necessary to specify the location of a local file to process.  A
  text entry field at the bottom of the plot can be used to type the path
  to a data file or the "Browse" button will bring up a file selector.
  After a file is chosen, the "Load File" button will process and display
  the entire file.  The "Quit" button will exit the application.

  Many common data analysis tools are built in to the display.  Notable
  for this application is the ability to select a point in time to
  display high-resolution time-domain waveform by left-clicking a point
  in the spectrogram.  A right-click on any plot component will pop up a
  menu with various options, including the capabilities of producing
  publication quality PostScript output or saving the current display as
  a PNG (portable network graphics) image.  Also note that the action
  performed by a left-click (or drag) can be modified.

  Almost any aspect of the display is configurable, and a number of
  convenient controls are accessible via mouse events on the display
  itself.  Any axis may be zoomed by left-dragging a range on the
  corresponding axis, time, frequency, or amplitude.  A subtle mouse
  "gesture," dragging a few pixels to the left (a left arrow will
  appear), may be used to undo the most recent zoom.  Another mouse
  gesture, dragging a few pixels down (a down arrow will appear) is used
  to zoom out.  Again, these mouse gestures are subtle and will not work
  if the mouse is dragged more than a few pixels.  If you move too far,
  the motion will be interpreted as a range to zoom instead of the "undo"
  or "zoom out" command.

  Again, right-clicking on a display element will bring up a menu that
  may be used to modify the default action of a mouse down event in the
  element, including for spectrograms tools such as a "Crosshair
  Digitizer," "Vertical Slice," "Horizontal Slice," and "Vertical
  Averager."  These are very useful for obtaining line plots of slices in
  time or frequency from the data used to generate the spectrograms.  In
  addition, a "properties" item will allow modifications of almost any
  other aspect of the presentation, including plot titles, axis styles,
  color or gray scales, etc.

  This application is an early release version of a very flexible display
  and analysis package currently under development.  For more
  information and updates, see http://www-pw.physics.uiowa.edu/das2/.

  =======================================================================