*********************************************************
*                       README                          *
*                  Data Display v8r05                   *
*                     19/10/2001                        *
*           D. Verkindt , D. Buskulic                   *
*     (verkindt@lapp.in2p3.fr, buskulic@lapp.in2p3.fr)  *
*********************************************************


This version of the VIRGO Data Display:
---------------------------------------

  - Uses Root instead of Hplot. This induces a lot of convenient users facilities
    like zooming, values pointing, saving of plot under various formats, etc...

  - Reads data under frame format (see /virgoApp/Fr documentation) from:
       - files (off-line)
       - files (online)
       - a Cm server (online)
       - the Data Distribution Server (online)

  - Displays and edits the following plots type:
    1D, 2D, Time, Spectrum, Transfert Function, Coherence Function, Correlation Function.

  - Dumps the last frame read, dump any selected channels of each frame read.

  - Saves the current configuration in a file that can also be read by Siesta (*.car file).

  - Loads a configuration from a file.


Some utilities are also available:
---------------------------------

  - FrCreate: to create on disk some frames containing sms, adc or proc data.
  - FrAudio:  to audio play one selected channel of data.
  - FrHisto:  to get a 1D, a Time and a Spectrum plot of one selected channel.


HOW TO USE IT:
-------------

  - Once in /virgoApp/Dy/vxx/OSF1, just type dataDisplay.
    You get the main panel. You can also put arguments: first one is the
    name of the configuration file you use, second is the number of frames
    you want to read, third is the debug level. For instance,
    "dataDisplay - - 3" means that you do not take any configuration initially,
    you do not set the number of frames to read and you set denug level to 3.

  - You can then, using "Config Menu", load a configuration file (*.car file).
    or, using the "Input Menu", select a data source (Cm Server, Files Online or Offline).

  - In the main panel, the white bottom line lets you know the
    last action you made or the current status of the data display.
    After selecting a data source, you should
    get there the message "Frame read successfully".

  - The "Data and Plots" panel allows to select channels and
    to create plots by pushing the button corresponding to the
    type of plot you want (1D, 2D, TIME, ...).
    For 2D histogram, you select first the 2 channels for X and Y,
    then push the "2D" button. Or select one channel for X, push
    the "2D" button and select then the channel for Y. the
    same remark applies to "TrFct", "Cohe" and "Corr" plots.


COMPILING:
---------

  - The following libraries are used:
        - /virgoApp/Root (Root libraries)
        - /virgoApp/Fr   (Frame library)
        - /virgoApp/Fd   (Frame Distribution library)
        - /virgoApp/Cm   (Cm and CSet libraries)
        - the GUI Xforms library

  - In the mgr directory, you will find old compiling scripts (obsolete):
        - makeDy: To compile only the data Display.
        - makeAll: To compile the data Display + the Utilities.
        - makeUtils: To compile the only the Utilities.

    and a makefile to compile the data Display (just do "gmake all"):
        - Makefile

  - The Xforms GUI is a free software but as a library.
    Sources are available on request to the developper (TC Zhao).
    Are available for now in Virgo the Xforms libraries for OSF1 or Linux
    systems. If you need data Display on an other platform,
    look at the Xform Web page (http://world.std.com/~xforms) or contact us.