README.md

   1 # LAPACK
   2
   3 [![Build Status](https://travis-ci.org/Reference-LAPACK/lapack.svg?branch=master)](https://travis-ci.org/Reference-LAPACK/lapack)
   4 [![Appveyor](https://ci.appveyor.com/api/projects/status/bh38iin398msrbtr?svg=true)](https://ci.appveyor.com/project/langou/lapack/)
   5 [![codecov](https://codecov.io/gh/Reference-LAPACK/lapack/branch/master/graph/badge.svg)](https://codecov.io/gh/Reference-LAPACK/lapack)
   6
   7
   8 * VERSION 1.0   :  February 29, 1992
   9 * VERSION 1.0a  :  June 30, 1992
  10 * VERSION 1.0b  :  October 31, 1992
  11 * VERSION 1.1   :  March 31, 1993
  12 * VERSION 2.0   :  September 30, 1994
  13 * VERSION 3.0   :  June 30, 1999
  14 * VERSION 3.0 + update :  October 31, 1999
  15 * VERSION 3.0 + update :  May 31, 2000
  16 * VERSION 3.1   : November 2006
  17 * VERSION 3.1.1 : February 2007
  18 * VERSION 3.2   : November 2008
  19 * VERSION 3.2.1 : April 2009
  20 * VERSION 3.2.2 : June 2010
  21 * VERSION 3.3.0 : November 2010
  22 * VERSION 3.3.1 : April 2011
  23 * VERSION 3.4.0 : November 2011
  24 * VERSION 3.4.1 : April 2012
  25 * VERSION 3.4.2 : September 2012
  26 * VERSION 3.5.0 : November 2013
  27 * VERSION 3.6.0 : November 2015
  28 * VERSION 3.6.1 : June 2016
  29 * VERSION 3.7.0 : December 2016
  30 * VERSION 3.7.1 : June 2017
  31
  32 LAPACK is a library of Fortran subroutines for solving the most commonly
  33 occurring problems in numerical linear algebra.
  34
  35 LAPACK is a freely-available software package. It can be included in commercial
  36 software packages (and has been). We only ask that that proper credit be given
  37 to the authors, for example by citing the LAPACK Users' Guide. The license used
  38 for the software is the modified BSD license, see:
  39 https://github.com/Reference-LAPACK/lapack/blob/master/LICENSE
  40
  41 Like all software, it is copyrighted. It is not trademarked, but we do ask the
  42 following: if you modify the source for these routines we ask that you change
  43 the name of the routine and comment the changes made to the original.
  44
  45 We will gladly answer any questions regarding the software. If a modification
  46 is done, however, it is the responsibility of the person who modified the
  47 routine to provide support.
  48
  49 LAPACK is available from github at:
  50 https://github.com/reference-lapack/lapack
  51
  52 LAPACK releases are also available on netlib at:
  53 http://www.netlib.org/lapack/
  54
  55 The distribution contains (1) the Fortran source for LAPACK, and (2) its
  56 testing programs.  It also contains (3) the Fortran reference implementation of
  57 the Basic Linear Algebra Subprograms (the Level 1, 2, and 3 BLAS) needed by
  58 LAPACK.  However this code is intended for use only if there is no other
  59 implementation of the BLAS already available on your machine; the efficiency of
  60 LAPACK depends very much on the efficiency of the BLAS.  It also contains (4)
  61 CBLAS, a C interface to the BLAS, and (5) LAPACKE, a C interface to LAPACK.
  62
  63 ## Installation
  64
  65  - LAPACK can be installed with `make`. The configuration have to be set in the
  66    `make.inc` file. A `make.inc.example` for a Linux machine running GNU compilers
  67    is given in the main directory. Some specific `make.inc` are also available in
  68    the `INSTALL` directory.
  69  - LAPACK includes also the CMake build. You will need to have CMake installed
  70    on your machine (CMake is available at http://www.cmake.org/). CMake will
  71    allow an easy installation on a Windows Machine.
  72  - Specific information to run LAPACK under Windows is available at
  73    http://icl.cs.utk.edu/lapack-for-windows/lapack/.
  74
  75
  76 ## User Support
  77
  78 LAPACK has been thoroughly tested, on many different types of computers. The
  79 LAPACK project supports the package in the sense that reports of errors or poor
  80 performance will gain immediate attention from the developers. Such reports,
  81 descriptions of interesting applications, and other comments should be sent by
  82 electronic mail to lapack@icl.utk.edu.
  83
  84 For further information on LAPACK please read our FAQ at
  85 http://www.netlib.org/lapack/#_faq.
  86
  87 A list of known problems, bugs, and compiler errors for LAPACK is
  88 maintained on netlib
  89 http://www.netlib.org/lapack/release_notes.html.
  90 Please see as well
  91 https://github.com/Reference-LAPACK/lapack/issues.
  92
  93 A User forum is also available to help you with the LAPACK library at
  94 http://icl.cs.utk.edu/lapack-forum/.
  95 You can also contact directly the LAPACK team at lapack@icl.utk.edu.
  96
  97
  98 ## Testing
  99
 100 LAPACK includes a thorough test suite. We recommend that, after compilation,
 101 you run the test suite.
 102
 103 For complete information on the LAPACK Testing please consult LAPACK Working
 104 Note 41 "Installation Guide for LAPACK".
 105
 106 ## User Guide
 107
 108 To view an HTML version of the Users' Guide please refer to the URL
 109   http://www.netlib.org/lapack/lug/lapack_lug.html.
 110
 111 ## LAPACKE
 112
 113 LAPACK now includes the LAPACKE package.  LAPACKE is a Standard C language API
 114 for LAPACK This was born from a collaboration of the LAPACK and INTEL Math
 115 Kernel Library teams. See:
 116 http://www.netlib.org/lapack/#_standard_c_language_apis_for_lapack.
 117