lapack-netlib/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 * VERSION 3.8.0 : November 2017
  32
  33 LAPACK is a library of Fortran subroutines for solving the most commonly
  34 occurring problems in numerical linear algebra.
  35
  36 LAPACK is a freely-available software package. It can be included in commercial
  37 software packages (and has been). We only ask that that proper credit be given
  38 to the authors, for example by citing the LAPACK Users' Guide. The license used
  39 for the software is the modified BSD license, see:
  40 https://github.com/Reference-LAPACK/lapack/blob/master/LICENSE
  41
  42 Like all software, it is copyrighted. It is not trademarked, but we do ask the
  43 following: if you modify the source for these routines we ask that you change
  44 the name of the routine and comment the changes made to the original.
  45
  46 We will gladly answer any questions regarding the software. If a modification
  47 is done, however, it is the responsibility of the person who modified the
  48 routine to provide support.
  49
  50 LAPACK is available from github at:
  51 https://github.com/reference-lapack/lapack
  52
  53 LAPACK releases are also available on netlib at:
  54 http://www.netlib.org/lapack/
  55
  56 The distribution contains (1) the Fortran source for LAPACK, and (2) its
  57 testing programs.  It also contains (3) the Fortran reference implementation of
  58 the Basic Linear Algebra Subprograms (the Level 1, 2, and 3 BLAS) needed by
  59 LAPACK.  However this code is intended for use only if there is no other
  60 implementation of the BLAS already available on your machine; the efficiency of
  61 LAPACK depends very much on the efficiency of the BLAS.  It also contains (4)
  62 CBLAS, a C interface to the BLAS, and (5) LAPACKE, a C interface to LAPACK.
  63
  64 ## Installation
  65
  66  - LAPACK can be installed with `make`. The configuration have to be set in the
  67    `make.inc` file. A `make.inc.example` for a Linux machine running GNU compilers
  68    is given in the main directory. Some specific `make.inc` are also available in
  69    the `INSTALL` directory.
  70  - LAPACK includes also the CMake build. You will need to have CMake installed
  71    on your machine (CMake is available at http://www.cmake.org/). CMake will
  72    allow an easy installation on a Windows Machine.
  73  - Specific information to run LAPACK under Windows is available at
  74    http://icl.cs.utk.edu/lapack-for-windows/lapack/.
  75
  76
  77 ## User Support
  78
  79 LAPACK has been thoroughly tested, on many different types of computers. The
  80 LAPACK project supports the package in the sense that reports of errors or poor
  81 performance will gain immediate attention from the developers. Such reports,
  82 descriptions of interesting applications, and other comments should be sent by
  83 electronic mail to lapack@icl.utk.edu.
  84
  85 For further information on LAPACK please read our FAQ at
  86 http://www.netlib.org/lapack/#_faq.
  87
  88 A list of known problems, bugs, and compiler errors for LAPACK is
  89 maintained on netlib
  90 http://www.netlib.org/lapack/release_notes.html.
  91 Please see as well
  92 https://github.com/Reference-LAPACK/lapack/issues.
  93
  94 A User forum is also available to help you with the LAPACK library at
  95 http://icl.cs.utk.edu/lapack-forum/.
  96 You can also contact directly the LAPACK team at lapack@icl.utk.edu.
  97
  98
  99 ## Testing
 100
 101 LAPACK includes a thorough test suite. We recommend that, after compilation,
 102 you run the test suite.
 103
 104 For complete information on the LAPACK Testing please consult LAPACK Working
 105 Note 41 "Installation Guide for LAPACK".
 106
 107 ## User Guide
 108
 109 To view an HTML version of the Users' Guide please refer to the URL
 110   http://www.netlib.org/lapack/lug/lapack_lug.html.
 111
 112 ## LAPACKE
 113
 114 LAPACK now includes the LAPACKE package.  LAPACKE is a Standard C language API
 115 for LAPACK This was born from a collaboration of the LAPACK and INTEL Math
 116 Kernel Library teams. See:
 117 http://www.netlib.org/lapack/#_standard_c_language_apis_for_lapack.
 118