home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / lib / mathlib / libblas / README < prev   
Encoding:
Text File  |  1994-08-02  |  5.1 KB  |  116 lines
  1. ------------------------------------------------------------------------------
  2. |  Copyright (c) 1991, 1992, 1993, 1994, Silicon Graphics, Inc.
  3. |  All Rights Reserved.
  4. |
  5. |  This library is provided for exclusive use on Silicon Graphics Computers
  6. |
  7. |  This is UNPUBLISHED PROPRIETARY SOURCE CODE of Silicon Graphics, Inc.;
  8. |  the contents of this file may not be disclosed to third parties, copied or
  9. |  duplicated in any form, in whole or in part, without the prior written
  10. |  permission of Silicon Graphics, Inc.
  11. | 
  12. |  RESTRICTED RIGHTS LEGEND:
  13. |  Use, duplication or disclosure by the Government is subject to restrictions
  14. |  as set forth in subdivision (c)(1)(ii) of the Rights in Technical Data
  15. |  and Computer Software clause at DFARS 252.227-7013, and/or in similar or
  16. |  successor clauses in the FAR, DOD or NASA FAR Supplement. Unpublished -
  17. |  rights reserved under the Copyright Laws of the United States.
  18. | 
  19. ------------------------------------------------------------------------------
  20.  
  21.  
  22. This directory contains the test programs, a demo program and the original
  23. source code for the BLAS (Basic Linear Algebra Subprograms). Optimized and
  24. parallelized versions of the BLAS for SGI platforms are available in a
  25. library, libblas. This library is provided with the SGI compilers and there
  26. are 4 different versions. The BLAS are also available in SGI's Scientific 
  27. Library "complib", which is available with the Fortran 4.0+ compiler.
  28.  
  29.   /usr/lib/libblas.a:           compiled with "-O2 " flags,
  30.                         will run on all systems.
  31.                         This is NOT a parallel version.
  32.  
  33.   /usr/lib/libblas_mp.a:        compiled with "-O2 -mp"
  34.                         will run on all systems.
  35.                         Requires Fortran compilers since it uses 
  36.                 the Fortran MP library.
  37.                         This version will run in parallel on 
  38.                 Power Series systems.
  39.  
  40.   /usr/lib/mips2/libblas.a:     compiled with "-O2 -mips2 " flags,
  41.                         will run only on systems with R4000 CPUs,
  42.                         This is NOT a parallel version.
  43.                        
  44.   /usr/lib/mips2/libblas_mp.a:  compiled with "-O2 -mips2 -mp" flags,
  45.                         will run only on systems with R4000 CPUs,
  46.                 Requires Fortran compilers since it uses
  47.                 the Fortran MP library.
  48.                         This version will run in parallel on
  49.                 Challenge and Onyx systems.
  50.                        
  51.  
  52. BLAS : Basic Linear Algebra Subprograms
  53.        There are three levels of BLAS:
  54.  
  55.        Level 1 BLAS: for vector operations such as  y <- alpha*x + y
  56.        Level 2 BLAS: for matrix vector ops such as  y <- alpha*A*x + beta*y
  57.        Level 3 BLAS: for matrix-matrix ops such as  C <- alpha*A*B + beta*C
  58.  
  59.        Here A, B and C are matrices, x and y are vectors and alpha and beta
  60.        are scalars.
  61.  
  62. ------------------------------------------------------------------------------
  63. WARNING --- Although these routines had been intensively tested,
  64.             it is possible that a few bugs are left.
  65.  
  66. ------------------------------------------------------------------------------
  67.     - The BLAS1 routines are not parallelized, the most important are hand-
  68.     coded in Assembly language. The optimized source code cannot be made 
  69.     available.
  70.  
  71.     - The original Fortran source code is provided for reference. It can
  72.     be found in the directory src_original
  73.  
  74. ------------------------------------------------------------------------------
  75. known problem:
  76.  
  77. Performance may be reduced when arrays are perfectly aligned to cache-size
  78. boundaries. This may happen when "leading" dimensions are powers of two.
  79. For example, it is better to declare a matrice (1025,1024), rather than
  80. (1024,1024).
  81. ------------------------------------------------------------------------------
  82. authors: this SGI version of LIBBLAS was Optimized and Parallelized for SGI 
  83.      computers by 
  84.         Mimi Celis 
  85.         Cheng Liao
  86.         Jean-Pierre Panziera 
  87.         Olivier Schreiber
  88.         Marco Thiele
  89. ------------------------------------------------------------------------------
  90. Send comments/complaints/bug reports to :
  91.  
  92.     Mimi Celis
  93.     Silicon Graphics
  94.     fax   : (415)967-6239
  95.     E-Mail: celis@esd.sgi.com
  96.  
  97. ------------------------------------------------------------------------------
  98. LINPACK is a Fortran set of subroutines which analyze and solve various
  99.     systems of simultaneous linear algebraic equations. It uses a
  100.     subset of the Level 1 BLAS.
  101.  
  102. LAPACK (Linear Algebra PACKage) puts together a new set of linear algebra 
  103.     functions, supposed to supplant both LINPACK and EISPACK packages.
  104.     To achieve maximum efficiency across all types of hardware, the
  105.     LAPACK routines are based on matrix-matrix BLAS 3 routines (e.g.
  106.     DGEMM). This implementation is much more performant than anything 
  107.     based on vector-vector Level 1 BLAS routines (e.g. DAXPY), or even 
  108.     matrix-vector Level 2 BLAS routines (e.g. DGEMV).
  109.  
  110. The directory ludec contains an example program that graphically demonstrates 
  111. the performance difference between the LU factorization in LINPACK, and the
  112. corresponding routine from LAPACK. To create the program, modify the Makefile
  113. to use the correct correct flags and libblas version for your machine. Then, 
  114. simply type make in the ludec directory. Type RUNTEST to run it.
  115. ------------------------------------------------------------------------------
  116.