home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / eispack-1.0-src.tgz / tar.out / contrib / eispack / INSTALL < prev    next >
Text File  |  1996-09-28  |  7KB  |  202 lines
  1.  
  2. Instructions for the Installation and Use of EISPACK
  3.  
  4.  
  5. This  note is  intended  to help a  person install  and test  
  6. EISPACK.  The  instructions  are designed for a person whose 
  7. responsibility is the maintenance of a mathematical software 
  8. library. We  assume the reader  has  a  working knowledge of 
  9. the computer system and some experience with  numerical cal-
  10. culations.  The  installation procedure  involves  reading a 
  11. magnetic tape, creating a  library from the Fortran  source, 
  12. then running and examining the output of the test programs.
  13.  
  14.  
  15. Tape Format
  16.  
  17.  
  18.      EISPACK is distributed in the form of a  magnetic  tape
  19. which  contains  the Fortran source for EISPACK, the testing
  20. aids and the initial program comments.
  21.  
  22.      The tape contains 55 files. The usual format is 9 track
  23. EBCDIC  or  ASCII,  unlabeled,  80  characters  per  logical
  24. record, 40 logical records per block, 1600 bpi.
  25.  
  26.  
  27. Tape Content
  28.  
  29.  
  30.      There are two versions of each routine in EISPACK: real
  31. (single) and double precision. These versions are written in
  32. standard ANSI  1966  Fortran  IV  and  are  totally  machine
  33. independent.  The installer should not have to change any of
  34. the EISPACK programs.  If a change is necessary  please  let
  35. us know what was changed.
  36.  
  37.  
  38. File 1   The information presented here on installing EISPACK
  39. File 2   Single Precision EISPACK            75 Subroutines
  40. File 3   Double Precision EISPACK            75 Subroutines
  41. File 4   A program to extract subroutines
  42.          from a sequential file
  43.  
  44.  
  45.      There is a collection of testing aids which should help
  46. in checking out EISPACK after it has been installed.
  47.  
  48. Test Aids
  49.  
  50.      Files 5-18    Single precision testing routines
  51.      Files 19-32   Double precision testing routines
  52.      Files 33-52   Input data for the test aids
  53.  
  54.  
  55.  
  56.  
  57.      In order to give the user some form of online  documen-
  58. tation  for  EISPACK, we have prepared a file which contains
  59. initial program comments. These comments describe,  in  gen-
  60. eral terms, what the routines do and the meaning of the cal-
  61. ling sequence parameters. This is not intended to be a  com-
  62. plete  discussion  of what the routines can do or how to use
  63. every facet of them.  For this information see [1,2].
  64.  
  65.  
  66. File 53   Initial Program Comments for the Single Precision Version
  67. File 54   Initial Program Comments for the Double Precision Version
  68.  
  69.  
  70. The last file on the tape, file 55, contains a  Unix  script
  71. for carrying out the testing on a Unix machine.
  72.  
  73. Creating a Library
  74.  
  75.  
  76.      For the creation of the library, first you must  decide
  77. which precision version of the package you intend to install
  78. at your site.
  79.  
  80. To install the single precision version you will  need  file
  81. 2.
  82.  
  83. To install the double precision version you will  need  file
  84. 3.
  85.  
  86. We suggest you compile and create a load module library from
  87. the appropriate file.
  88.  
  89.      To help in extracting individual EISPACK routines  from
  90. the  sequential file on the tape we have provided a program.
  91. This program, given a file containing many subroutines  will
  92. produce  many  files  each containing a single subroutine or
  93. function. The file name will be the same as  the  subprogram
  94. followed  by ".f".  This program that does this can be found
  95. in file 4.
  96.  
  97.  
  98. Testing
  99.  
  100.  
  101.      After the library is created, the testing  aids  should
  102. be  run.  The testing aids are in files 5-32 on the tape and
  103. are organized as follows:
  104.  
  105.  
  106.    File          Name          File          Name
  107.           (single precision)          (double precision)
  108.     5            RG             19           RG
  109.     6            RS             20           RS
  110.     7            RSB            21           RSB
  111.     8            RSP            22           RSP
  112.     9            RST            23           RST
  113.     10           RT             24           RT
  114.     11           CG             25           CG
  115.     12           CH             26           CH
  116.     13           RGG            27           RGG
  117.     14           RSG            28           RSG
  118.     15           RSGAB          29           RSGAB
  119.     16           RSGBA          30           RSGBA
  120.     17           RL             31           RL
  121.     18           RBL            32           RBL
  122.  
  123.  
  124.      Each test file contains a main program and several sub-
  125. routines which read in test matrices or compute a residual.
  126.  
  127.      The test programs require some input data to  run.  The
  128. input data can be found in files 33-52.
  129.  
  130.  
  131.   File     Name       File for         File for         File for
  132.                    Input Data on    Input Data on    Input Data on
  133.                    Logical Unit 1   Logical Unit 2   Logical Unit 5
  134.  
  135. 5 or 19     RG           33              none              34
  136. 6 or 20     RS           35              none              36
  137. 7 or 21     RSB          37              none              38
  138. 8 or 22     RSP          35              none              36
  139. 9 or 23     RST          51              none              52
  140. 10 or 24    RT           39              none              40
  141. 11 or 25    CG           41              none              42
  142. 12 or 26    CH           43              none              44
  143. 13 or 27    RGG          45               46              none
  144. 14 or 28    RSG          35               47               36
  145. 15 or 29    RSGAB        35               47               36
  146. 16 or 30    RSGBA        35               47               36
  147. 17 or 31    RL           48              none             none
  148. 18 or 32    RBL          49              none              50
  149.  
  150.  
  151.      Small changes may be required in the test drivers,  for
  152. example to change the the logical unit input or output or to
  153. include a program card.  The test drivers require input data
  154. to be read.  This test data is contained in files 33-52, and
  155. is described in more detail later. We  have  used  the  OPEN
  156. statement  in Fortran 77 to associate the data file with the
  157. appropriate logical unit number.  If you do not have a  com-
  158. piler  that  supports  Fortran  77, you must remove the OPEN
  159. statement and  associate  the  input  data  files  with  the
  160. appropriate logical unit.
  161.  
  162.      The amount of time required to complete the  test  runs
  163. is small.
  164.  
  165.  
  166. Comments and Questions
  167.  
  168.  
  169.      We hope that  no  difficulty  will  be  encountered  in
  170. installing  EISPACK,  but if a problem occurs we will try to
  171. help. We are especially interested  in  comments  about  the
  172. performance  of the codes.  These comments and questions can
  173. be directed to:
  174.  
  175.   Jack Dongarra
  176.   Mathematics and Computer Science Division
  177.   Argonne National Laboratory
  178.   Argonne, Illinois 60439
  179.  
  180.   Phone: (312) 972-7246
  181.  
  182.   ARPA-NET: DONGARRA@ANL-MCS
  183.  
  184.  
  185.  
  186.  
  187.   REFERENCES
  188.  
  189.  
  190.   [1]  B.T. Smith, J.M. Boyle, J.J. Dongarra,  B.S.  Garbow,
  191.        Y. Ikebe, V.C. Klema and C.B. Moler, Matrix Eigensys-
  192.        tem Routines - EISPACK Guide, Lecture Notes  in  Com-
  193.        puter Science, Vol. 6, 2-nd Edition, Springer-Verlag,
  194.        Berlin, 1976.
  195.  
  196.  
  197.   [2]  B.S. Garbow,  J.M.  Boyle,  J.J.  Dongarra  and  C.B.
  198.        Moler,  Matrix  Eigensystem  Routines - EISPACK Guide
  199.        Extension, Lecture Notes in  Computer  Science,  Vol.
  200.        51, Springer-Verlag, Berlin, 1977.
  201.  
  202.