This is the README file for the ssvd program that is a driver program for
my wrapper library LIBMYSSVD.

### NOTE!!!! ###
In this version, only LAS1 and LAS2 routines have been tested to work. The
others are not yet fully supported...and will be supported some day in the 
future. 
---------------

# REQUIREMENTS FOR BUILDING
----------------------------
1. gcc version greater than 3, the library is not compatible with older versions
   of the compiler

2. GNU scientific library (libgsl)

# BUILDING THE DRIVER PROGRAM AND LIBMYSSVD
-------------------------------------------
To build the program do the following

  1. Untar the file ssvd-0.2.3.tar.gz
  2. cd ssvd-0.2.3/src
  2.1 EDIT the makefile to reflect the correct location of GSL
  3. make

Additionally if you want to build the example program in the 'examples'
subdirectory, you should also do 'make lib' in the 'src' directory.


that is all! You may additionally compile the documentation in
ssvddoc.tex or you may access it at the following webpage

http://www.cs.utexas.edu/users/suvrit/work/progs/ssvd.html

# USAGE
-------
Sample data matrices are included in the directory 'data'
Various README.x files in the 'ssvd-0.2.3' directory describe the behavior.


Thus a sample command line to compute the singular values and
singular vectors is:

$ ./ssvd -f ../data/test2 -t txx -o ../data/test2.las1 -a 1 -v

Use ssvd -h to know the meaning of these options.

Feel free to contact me == suvrit at cs dot utexas dot edu if you have any
concerns.