raw/manl/lapack.l

   1 .TH LAPACK l "2 April 1993" "LAPACK Version 1.1" "LAPACK FORTRAN LIBRARY ROUTINES"
   2
   3 .SH WHAT IS LAPACK?
   4 .in -0.3i
   5 LAPACK is a transportable library of Fortran 77 subroutines for
   6 solving the most common problems in numerical linear algebra: systems
   7 of linear equations, linear least squares problems, eigenvalue problems,
   8 and singular value problems. It has been designed to be efficient
   9 on a wide range of modern high-performance computers.
  10
  11 LAPACK is intended to be the successor to LINPACK and EISPACK.
  12 It extends the functionality of these packages by including
  13 equilibration, iterative refinement, error bounds, and driver routines
  14 for linear systems, routines for computing and re-ordering the Schur
  15 factorization, and condition estimation routines for eigenvalue
  16 problems.  LAPACK improves on the accuracy of the standard algorithms
  17 in EISPACK by including high accuracy algorithms for finding singular
  18 values and eigenvalues of bidiagonal and tridiagonal matrices
  19 respectively that arise in SVD and symmetric eigenvalue problems.
  20 The algorithms and software have been restructured to achieve high
  21 efficiency on vector processors, high-performance ``superscalar''
  22 workstations, and shared-memory multiprocessors.
  23 A comprehensive testing and timing suite is provided along with the
  24 LAPACK software.
  25
  26 .SH HOW TO GET LAPACK
  27 .in -0.3i
  28 The entire LAPACK package is available via xnetlib and NAG, or specific
  29 routines can be obtained via netlib.  To see a description of the
  30 contents of LAPACK, send email to netlib@ornl.gov and in the mail
  31 message type: send index from lapack.
  32
  33 Xnetlib is an X-version of netlib recently developed at the University
  34 of Tennessee and Oak Ridge National Laboratory.  Unlike netlib, which
  35 uses electronic mail to process requests for software and other text,
  36 xnetlib uses an X Window graphical user interface and a socket-based
  37 connection between the user's machine and the xnetlib server machine to
  38 process software requests. The complete contents of LAPACK is available
  39 in tar/compress format from xnetlib.
  40
  41 To receive a copy of xnetlib send the message "send xnetlib.shar from
  42 xnetlib" to netlib@ornl.gov.
  43
  44 When you receive the shar file, remove the mail header, save it to a
  45 file, type 'sh filename' and follow the instructions in the README
  46 file.
  47
  48 Alternatively, the complete LAPACK package can be
  49 obtained from NAG on magnetic media for a handling charge.
  50 For further details contact NAG at one of the following addresses:
  51
  52 .nf
  53 NAG Inc                       NAG Ltd              NAG GmbH
  54 1400 Opus Place               Wilkinson House      Schleissheimerstrasse 5
  55 Suite 200                     Jordan Hill Road     W-8046 Garching bei Munchen
  56 Downers Grove, IL 60515-5702  Oxford OX2 8DR       Germany
  57 USA                           England
  58 Tel: +1 708 971 2337          Tel: +44 865 511245  Tel: +49 89 3207395
  59 Fax: +1 708 971 2706          Fax: +44 865 310139  Fax: +49 89 3207396
  60 .fi
  61
  62 LAPACK has been thoroughly tested, on many different
  63 types of computers.  The LAPACK project supports the package in the
  64 sense that reports of errors or poor performance will gain immediate
  65 attention from the developers. Such reports, descriptions
  66 of interesting applications, and other comments should be sent by
  67 electronic mail to lapack@cs.utk.edu.
  68
  69 .SH LAPACK USERS' GUIDE
  70 .in -0.3i
  71 The LAPACK Users' Guide is published by SIAM and was made available
  72 May, 1992.  LAPACK Users' Guide gives an informal introduction to
  73 the design of the algorithms and software, summarizes the contents
  74 of the package, and describes the conventions used in the software
  75 and documentation, and includes complete specifications for calling
  76 the routines.  The LAPACK Users' Guide can be purchased from:
  77 SIAM; 3600 University City Science Center; Philadelphia, PA 19104-2688;
  78 215-382-9800, FAX 215-386-7999.  It will also be available from
  79 booksellers.  The Guide costs $15.60 for SIAM members, and $19.50
  80 for non-members.  Please specify order code OT31 when ordering.
  81 To order by email, send email to service@siam.org.
  82
  83 A list of known problems, bugs, and compiler errors for LAPACK, as
  84 well as errata for the LAPACK Users' Guide and the LAPACK code itself, is
  85 maintained on netlib.  For a copy of this report, send email to
  86 netlib@ornl.gov with a message of the form: send release_notes from
  87 lapack.
  88
  89 .SH LAPACK WORKING NOTES
  90 .in -0.3i
  91 A number of working notes were written during the
  92 development of LAPACK and published as LAPACK Working Notes,
  93 initially by Argonne National Laboratory and later by the University
  94 of Tennessee.  Many of these reports have subsequently appeared as
  95 journal articles.  Most of these working notes are available in postscript
  96 form from netlib.  To receive a list of available reports, send email to
  97 netlib@ornl.gov with a message of the form: send index from lapack/lawns.
  98 Otherwise, requests for copies of these working notes can be sent to
  99 the following address.
 100
 101 LAPACK Project
 102 c/o J.J. Dongarra
 103 Computer Science Department
 104 University of Tennessee
 105 Knoxville, Tennessee 37996-1301
 106 USA
 107 Email: lapack@cs.utk.edu
 108
 109 .SH ACKNOWLEDGEMENTS
 110 .in -0.3i
 111 LAPACK has been funded in part by NSF, DOE, and DARPA, with
 112 developmental support from NAG Ltd., Cray Research, and many friends
 113 and colleagues around the world.
 114
 115
 116 Ed Anderson, Zhao-jun Bai, Chris Bischof, Jim Demmel, Jack Dongarra,
 117 Jeremy Du Croz, Anne Greenbaum, Sven Hammarling, Alan McKenney,
 118 Susan Ostrouchov, and Danny Sorensen
 119
 120              (           l    l    l    l )
 121              (           a   -a    a   -a )
 122        1/4 * ( p    p             -p   -p )
 123              ( a   -a             -a    a )
 124              ( c    c   -c   -c           )
 125              ( k   -k   -k    k           )
 126
 127
 128 .SH NAMING SCHEME
 129 .in -0.3i
 130 The name of each LAPACK routine is a coded specification of
 131 its function (within the very tight limits of standard Fortran 77
 132 6-character names).
 133
 134 All driver and computational routines have names of the form XYYZZZ,
 135 where for some driver routines the 6th character is blank.
 136
 137 The first letter, X, indicates the data type as follows:
 138
 139       S  REAL
 140       D  DOUBLE PRECISION
 141       C  COMPLEX
 142       Z  COMPLEX*16  or DOUBLE COMPLEX
 143
 144 The next two letters, YY, indicate the type of matrix (or of the most
 145 significant matrix).  Most of these two-letter codes apply to both real
 146 and complex matrices; a few apply specifically to one or the other.
 147
 148 The last three letters ZZZ indicate the computation performed.
 149 For example, SGEBRD is a single precision routine that performs a
 150 bidiagonal reduction (BRD) of a real general matrix.