Using Wavelet Analysis Tool (WAT) at computers
    of Physics Department of University of Florida
    -----------------------------------------------

      WAT is avalilable for use as static and shared libraries
   installed at Sun Microsystems computer cluster at Physics
   Department of University of Florida. Libraries reside in
   directory /ligo/tmp3/sw/lib/wat. WAT header files are placed
   at /ligo/tmp3/sw/include/wat.

      For data access from files in LIGO frame format WAT uses
   packages Data Monitoring Tool (DMT) and Virgo Frame Library (FR).
   These packages are installed in /ligo/tmp3/sw/dmt122 and
   /ligo/tmp3/sw/Fr.
   
      WAT benefit much from usage with ROOT system (http://root.cern.ch).
   ROOT system appropriate for use with WAT is installed at /ligo/tmp3/sw/root.

      To take advantage of ROOT's graphical capabilities user must work
   on some computer running X-Window system (most graphical Unix consoles
   and X-Terminals) or he must use some X-Window emulation software
   on personal computer (for example "XWin-32", "EXceed" or "PC-Xware").

     *Note: ROOT may run without graphical capabilities via
  any hardware/software which is capable of only telnet or alphanumeric
  terminal connections to Unix host. Just start ROOT in batch mode
  via command 'root -b'.

      The ROOT system, WAT, FR and other packages intended to be used
   with ROOT must be compiled via the same compiler. All packages
   mentioned here are compiled via GNU C/C++ compiler ver. 2.95.2
   which is available as 'gcc' and 'g++' in directory /ligo/tmp3/sw/bin.
   This version of gcc/g++ were build with GNU linker (ld) and assembler (gas).
   To develop new code for ROOT user must ensure that this 'gcc' and 'g++'
   take preference against system's default programs.
   This may accomplished by changing variable 'path':

      set path=(/ligo/tmp3/sw/bin $path )

   The same thing must be done for 'LD_LIBRARY_PATH':

      setenv LD_LIBRARY_PATH /ligo/tmp3/sw/lib:${LD_LIBRARY_PATH}

   For proper operation ROOT system requires to set environment variables:

      setenv ROOTSYS /ligo/tmp3/sw/root
      setenv LD_LIBRARY_PATH "$LD_LIBRARY_PATH":$ROOTSYS/lib
      set path=( $path $ROOTSYS/bin )

   DMT settings:

      setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:/ligo/tmp3/sw/dmt122/lib
      set path = ( $path /ligo/tmp3/sw/dmt122/bin )

    for those, who want to compile their own code for ROOT, it is
    recommended to include in 'path' the directory with properly
    tuned compilers gcc, g++, and other utilities:

      set path = ( /ligo/tmp3/sw/bin $path )

  All these settings may be accomplished in moment via command:

      source /ligo/tmp3/sw/ligo_env

  where 'ligo_env' is the file with all recommended settings.
  Instead you may add this commands to the end of the file .cshrc
  which resides in your home directory.

     There is important file .rootrc which should reside in your
  home directory and which defines ROOT behaiviour. If you do not
  have this file then copy /ligo/tmp3/sw/.rootrc to your home directory.

     File .rootrc must contain references to directories where
  DMT and WAT shared libraries installed and optionaly to directories
  where DMT and WAT macros installed. As for macros you may prefer
  to copy the desired ones to your working directory.

     For ROOT to be able to find DMT's shared libraries .rootrc must
  contain the statement like this:

    Unix.*.Root.DynamicPath:    .:$(ROOTSYS)/lib:/ligo/tmp3/sw/dmt/lib

  WAT's shared library wavelet.so is currently in $(ROOTSYS)/lib, and
  do not require dedicated settings. 

     The reference to macro directories should look like this:

  Unix.*.Root.MacroPath: .:/ligo/tmp3/sw/dmt/include:/ligo/tmp3/sw/dmt/macros  

     For use of DMT it may be convinient to include at the end of the
  file .rootrc two strings:

    LIGO.Rint.Logon:  sboxlogon.C
    *.Rint.Logoff:    sboxlogoff.C

     But for doing your own things it is more convinient to have one
  string at the end of .rootrc :

    Rint.Logon:     rootlogon.C

  Then you may place any useful commands in the file 'rootlogon.C'
  which must be created at your working directory (usually is not the
  same as home directory). Your rootlogon.C will be executed at the
  begining of each ROOT session. Example of rootlogon.C file is
  included in WAT distribution in directory macro. Look at lines
  with commands loading shared libraries and macros. Edit those lines
  if in your system libraries and macros installed in other locations.
  
     For using WAT classes you need issue the command in ROOT session:

     gSystem->Load("libROOTwavelet.so");

  or better add this command to your rootlogon.C.

  To check if WAT classes are available issue the command:

     .class Wavelet

  if everything right you should see screen like this:

  root [0] .class Wavelet
  ===========================================================================
  class Wavelet //Wavelet Base Class
   size=0xc
   (tagnum=464,voffset=-1,isabstract=0,parent=-1,gcomp=0,=~cd=0)
  List of base class--------------------------------------------------------
  0x0        public: TObject //Basic ROOT object
  List of member variable---------------------------------------------------
  Defined in Wavelet
  0x0        private: static TClass* fgIsA
  List of member function---------------------------------------------------
  filename       line:size busy function type and name  (in Wavelet)
  (compiled)        0:0    0 public: Wavelet Wavelet(void); //Constructor
  (compiled)        0:0    0 public: const char* DeclFileName(void);
  (compiled)        0:0    0 public: int DeclFileLine(void);
  (compiled)        0:0    0 public: const char* ImplFileName(void);
  (compiled)        0:0    0 public: int ImplFileLine(void);
  ....

     WAT macroces are available with WAT distribution in directory 'macro'.
  You are advised either copy those you need to your working directory
  or add the reference to that directory to Unix.*.Root.MacroPath:
  in your .rootrc.

     The brief documentation on WAT's classes, data structures and
  methods is currently available on page http://www.phys.ufl.edu/LIGO/wavelet.

------------------------------------------------------------
  A.Sazonov (sazonov@phys.ufl.edu, sazonov@thsun1.jinr.ru).

  June 8, 2001