===================
xSYGVIC Readme File
===================

-------------------------------
Test Run of the xSYGVIC package
-------------------------------
* To test the xSYGVIC package, just type:
  ./test

  If all work correctly (compile, execution ..), file ``out.txt''
  will be generated in the same directory. It reports the test cases
  and computed results. 

* If necessary, you need to change the permission of 'test' 
  to make it executable: 
  chmod 755 test

-----------------------
BLAS and LAPACK Library
-----------------------
* If BLAS and LAPACK are not installed on your machine, type 'make' will 
  generate the LAPACK library with the associated LAPACK files in the 
  directory 'lapacklib'.

* For better performance, if BLAS and LAPACK are available on your machine,
  say Intel's MKL, modify 'make.inc' to specify:
  (1) LAPACK_DIR
  (2) LAPACK_LIB
  and comment the line:
  LAPACK_LIB = $(MAIN_DIR)/liblapack.a

--------
Compiler
--------
* Install 'gfortran' if there is not fortran compiler on your machine.
  On Ubuntu, type:
  sudo apt-get install gfortran

* If Intel's MKL is to be used, change the complier from 'gfortran' 
  to 'ifort' in the file 'make.inc'.

------------------------
Run individual test case
------------------------
* The main test routine is 'tstdsygvic.f90' in the directory /example.

* After successfully compiling the package, a test execution file named
  'tstdsygvic' will be generated in /example.

* To simply run the test /example, type:
  ./tstdsygvic Aname Bname output
  where Aname and Bname are names of the matrix files, and
  output is the name of the output file.

--------------------------
Format of the Input Matrix
--------------------------
* The first line of matrix file specify the order of the matrix, and the
  following lines are the data of the matrix.

-----------
Directories 
-----------
    lapacklib .... Sourcecode of blas and lapack (only contains the 
                   subroutines to be used)
    src .......... Source code
    example ...... Test examples of the code
    doc .......... Working notes