FVIEW 1.2 BASE RELEASE
-----------------------

What is Fview?
--------------

The program fview is used for projecting higher dimensional data down
onto the screen of the computer and manipulating it in various ways. It
is particularly useful (and designed for) speech data in the form of
trajectories in twelve dimensional space, and some is included. Also
included, full instructions for using standard data base data sets
to get more data. There is a full manual included in the tar file.

For fun and profit, run the three dimensional sweep presentation of an
utterance such as `six', and watch it spring out and hit you in the eye
at the vowel, and dip back for the stop. Great for checking end-pointing
and for exploring front-ends for speech recognition systems; can be used
with minor modifications for viewing, rotating and time sequencing high
dimensional data of all sorts.  Easily learnt graphics user interface makes
it all a doddle to play with.

What hardware is required?
--------------------------

Two ports of fview are currently available:  SunOS and Linux.
SunOS Fview was developed on a SparcStation II under SunOS 4.3.1.  It uses
OpenWindows and XView libraries.  It requires a colour X-windows display.
Linux Fview was developed on a i486 PC using Linux 1.0.  It requires XFree86
and Xview to compile and needs 8Mb or more of memory to run.  It requires a
colour display (of at least 1024x768 to be useful).

What additional software is required?
-------------------------------------

1.  X-windows libraries.
2.  XView libraries.
3.  The OpenWindows window manager (olwm or olvwm).
4.  gcc (or an ANSI `C' compiler)
5.  gunzip (to use online data decompression).
6.  latex (to compile the manuals producing .dvi files)
7.  dvips (to generate postscript manuals)

How do I compile Fview?
-----------------------

Once unpacked perform the following steps.
1.  Edit the Makefile.
2.  Setup paths to uncompress and gunzip in the file paths.h
3.  `make all' in this directory to compile fview.
4.  `cd src; make all' to create the device drivers needed by fview.
5.  `make install' to install the drivers.
6.  `cd ..'

If documentation is required.

7.  `cd doc; make all' to create the linux documentation postscript files.
8.  `ghostview manual.ps' to view the resulting postscript.

Note: the total unpacked documentation directory requires circa 10Mb
(but the *.dvi files constitute a small proportion of this space.)

Directory Structure
-------------------

  ./docs      Documentation in latex and diagrams in encapsulated postscript.
  ./lists     Example list files (data not supplied).
  ./drivers   Format converters and Front-end executables.
  ./src       Source code for driver programs.

Important files:
  ./Makefile      Makefile for generating fview (customize before use).
  ./Formats       Configuration file for format converters.
  ./Frontends     Configuration file for front-end filters.
  ./src/Makefile  Makefile for format converter and front-end programs.
  ./src/Makefile  Latex documentation Makefile

Fview source files (most have associated .h files):
  ./paths.h      Locations of system utilities `uncompress' and `gunzip' to
                 compile into fview and its drivers.
  ./fview.c      Main source file for fview.
  ./interface.c  Interface to the xview library.
  ./projectors.c Screen refresh routines for 2D/3D and spectrograms.
  ./callbacks.c  Callback routines.
  ./entropy.c    Trajectory prediction and vertex highlighting using entropy.
  ./fviewio.h    Header containing structures for interface to converters.
  ./ctable.c     Colour table support functions.
  ./dbuffer.c    Double buffering functions.
  ./timer.c      Delay timer functions.
  ./colours.c    3D colour setting functions
  ./eigensys.c   Eigenvector analysis functions.

Key Driver source files (some have associated .h files):
  ./src/ascii.c     ASCII record format converter.
  ./src/ciips.c     CIIPS group format converter.
  ./src/nist.c      NIST format converter.
  ./src/timit.c     TIMIT format converter.
  ./src/htk.c       HTK format converter.
  ./src/fbank.c     Filter bank front end driver.
  ./src/lpc.c       LPC and Cepstral front end driver.
  ./src/fvw2ascii.c FView binary file to ASCII converter.

-----------
Gareth Lee.
27-06-94
