===================
micMAGMA README FILE
===================

VERSION 0.1  :  April     2012
VERSION 0.2  :  May       2012
VERSION 1.0b :  March     2013 (beta)
VERSION 1.0  :  May       2013

* To INSTALL and use micMAGMA, first set MKL and compiler variables by
  sourcing for example
  > source /mnt/scratch/sw/intel/composerxe_mic.0.022/bin/compilervars.sh intel64
  > source /mnt/scratch/sw/intel/composerxe_mic.0.022/mkl/bin/mklvars.sh intel64
  Second, modify the make.inc file for your system.
  Then typing 'make' will create:
   1) the libmicmagma.a and libmicmagmablas.a libraries in directory 'lib'
   2) testing drivers in directory 'testing'.

* To TEST micMAGMA, go to directory 'testing'. Provided are a number of
  drivers testing different routines. These drivers are also useful
  as examples on how to use micMAGMA, as well as to benchmark the performance.
 
* To TUNE micMAGMA, you can modify the blocking factors for the algorithms of
  interest in file 'control/get_nb_mic.cpp'.

For more INFORMATION, please refer to the MAGMA homepage and user forum:

  http://icl.cs.utk.edu/magma/
  http://icl.cs.utk.edu/magma/forum/

The MAGMA project supports the package in the sense that reports of 
errors or poor performance will gain immediate attention from the 
developers. Such reports, descriptions of interesting applications, 
and other comments should be posted on the MAGMA user forum.

