STYLE: Remove trailing whitespace in MISC files
[platform/upstream/lapack.git] / README
1 ==================
2 LAPACK README FILE
3 ==================
4
5 VERSION 1.0   :  February 29, 1992
6 VERSION 1.0a  :  June 30, 1992
7 VERSION 1.0b  :  October 31, 1992
8 VERSION 1.1   :  March 31, 1993
9 VERSION 2.0   :  September 30, 1994
10 VERSION 3.0   :  June 30, 1999
11 VERSION 3.0 + update :  October 31, 1999
12 VERSION 3.0 + update :  May 31, 2000
13 VERSION 3.1   : November 2006
14 VERSION 3.1.1 : February 2007
15 VERSION 3.2   : November 2008
16 VERSION 3.2.1 : April 2009
17 VERSION 3.2.2 : June 2010
18 VERSION 3.3.0 : November 2010
19 VERSION 3.3.1 : April 2011
20 VERSION 3.4.0 : November 2011
21 VERSION 3.4.1 : April 2012
22 VERSION 3.4.2 : September 2012
23 VERSION 3.5.0 : November 2013
24 VERSION 3.6.0 : November 2015
25 VERSION 3.6.1 : June 2016
26
27
28 LAPACK is a library of Fortran 90 with subroutines for solving
29 the most commonly occurring problems in numerical linear algebra.
30 It is freely-available software, and is copyrighted.
31
32 LAPACK is available on netlib and can be obtained via the World Wide
33 Web and anonymous ftp.
34
35    http://www.netlib.org/lapack/
36
37 The distribution tar file contains the Fortran source for LAPACK and the
38 testing programs.  It also contains the Fortran77
39 reference implementation of the Basic Linear Algebra Subprograms
40 (the Level 1, 2, and 3 BLAS) needed by LAPACK.  However this code is
41 intended for use only if there is no other implementation of the BLAS
42 already available on your machine; the efficiency of LAPACK depends
43 very much on the efficiency of the BLAS.
44
45 =================
46 LAPACK INSTALLATION:
47  - LAPACK can be installed with make. Configuration have to be set in the
48  make.inc file. A make.inc.example for a Linux machine running GNU compilers
49  is given in the main directory. Some specific make.inc are also available in
50  the INSTALL directory
51  - LAPACK includes also the CMAKE build. You will need to have CMAKE installed
52  on your machine (CMAKE is available at http://www.cmake.org/). CMAKE will allow
53  an easy installation on a Windows Machine
54  - Specific information to run LAPACK under Windows are available at
55  http://icl.cs.utk.edu/lapack-for-windows/lapack/
56
57  For further information on LAPACK please read our FAQ at
58  http://www.netlib.org/lapack/#_faq
59  A User forum is also available to help you with the LAPACK library at
60  http://icl.cs.utk.edu/lapack-forum/
61 ================
62
63
64 ================
65 LAPACK User Support
66
67 LAPACK has been thoroughly tested, on many different
68 types of computers.  The LAPACK project supports the package in the
69 sense that reports of errors or poor performance will gain immediate
70 attention from the developers. Such reports, descriptions
71 of interesting applications, and other comments should be sent by
72 electronic mail to lapack@cs.utk.edu.
73
74 A list of known problems, bugs, and compiler errors for LAPACK is
75 maintained on netlib.
76   http://www.netlib.org/lapack/release_notes.html
77
78 A User forum is also available to help you with the LAPACK library at
79  http://icl.cs.utk.edu/lapack-forum/
80 You can also contact directly the LAPACK team at lapack@cs.utk.edu
81 ================
82
83
84 ================
85 LAPACK TESTING
86 The complete package, including test code in four
87 different Fortran data types (real, complex, double precision, double
88 complex), contains some 805,000 lines of Fortran source and comments.
89 You will need approximately 33 Mbytes to read the complete tape.
90 We recommend that you run the testing.  The total
91 space requirements for the testing for all four data
92 types, including the object files, is approximately 80 Mbytes.
93
94 A README file containing the information in this letter is located
95 in the LAPACK directory. Postscript and LaTeX versions of the Quick
96 Installation Guide are in the LAPACK/INSTALL directory, in the files
97 lawn81.tex, psfig.tex, lawn81.ps, and org2.ps.  Consult the Installation
98 Guide for further details on installing the package and on what is contained
99 in each subdirectory.  For complete information on the LAPACK Testing
100 please consult LAPACK Working Note 41 "Installation
101 Guide for LAPACK".
102 ================
103
104
105 ================
106 LAPACK USER GUIDE
107 It is highly recommended that you obtain a copy of the Third Edition of
108 the LAPACK Users' Guide published by SIAM in Winter, 1999.  This Users'
109 Guide gives a detailed description of the philosophy behind LAPACK as well
110 as an explanation of its usage.  The LAPACK Users' Guide can be purchased from:
111 SIAM; Customer Service; P. O. Box 7260; Philadelphia, PA 19104;
112 215-382-9800, FAX 215-386-7999.  It will also be available from booksellers.
113
114 To order by email, send email to service@siam.org.  The book is also
115 available via SIAM's World Wide Web URL at http://www.siam.org.  The
116 ISBN number is 0-89871-447-8, and SIAM order code is SE09.  The list
117 price for SIAM members is $31.20; the cost for nonmembers is $39.00.
118
119 To view an HTML version of the Users' Guide please refer to the URL
120
121   http://www.netlib.org/lapack/lug/lapack_lug.html.
122 ================
123
124 ================
125 LAPACKE
126 LAPACK now includes the LAPACKE package
127 LAPACKE is a Standard C language APIs for LAPACK
128 http://www.netlib.org/lapack/#_standard_c_language_apis_for_lapack
129 collaboration LAPACK and INTEL Math Kernel Library
130
131 Documentation available in the DOCS folder
132 ================
133
134 ================
135 RELATED LAPACK PROJECTS
136
137 The Fortran95 interface to LAPACK is available, as well as an f2c'ed
138 version of LAPACK, and a C++ version of a subset of LAPACK routines.
139 Refer to the following URLs on netlib for further information:
140
141   http://www.netlib.org/lapack95/
142   http://www.netlib.org/clapack/
143   http://www.netlib.org/lapack++/
144   http://www.cs.utk.edu/java/f2j/
145
146 Or, for more information on the distributed-memory version of LAPACK,
147 consult the ScaLAPACK index on netlib:
148
149   http://www.netlib.org/scalapack/
150 ================
151
152
153 ================
154 LAPACK WORKING NOTES
155
156 A number of technical reports were written during the development of
157 LAPACK and published as LAPACK Working Notes, initially by Argonne
158 National Laboratory and later by the University of Tennessee.  Many of
159 these reports later appeared as journal articles.  Most of these working
160 notes are available in pdf and postscript form from netlib.
161   http://www.netlib.org/lapack/lawns/
162   http://www.netlib.org/lapack/lawnspdf/
163 Otherwise, requests for copies of these working notes can be sent to
164 the following address.
165
166 LAPACK Project
167 c/o J.J. Dongarra
168 Computer Science Department
169 University of Tennessee
170 Knoxville, Tennessee 37996-1301
171 USA
172 Email: lapack@cs.utk.edu
173 ================