(BEGINNING OF READ-ME.NMS)

     From the book "Numerical Methods and Software"
          by  D. Kahaner, C. Moler, S. Nash
               Prentice Hall 1988

This disk contains the files

   READ-ME.NMS      (This file)
   NMSCH00.ARC      (Source programs for subroutines in the book that are
                      used by routines from several different chapters.)
   NMSCH03.ARC      (Source programs for the routines from Chapter 3.)
   NMSCH04.ARC      (  ... from Chapter 4.)
   NMSCH05.ARC      (  ... from Chapter 5.)
   NMSCH06.ARC      (  ... from Chapter 6.)
   NMSCH07.ARC      (  ... from Chapter 7.)
   NMSCH08.ARC      (  ... from Chapter 8.)
   NMSCH09.ARC      (  ... from Chapter 9.)
   NMSCH10.ARC      (  ... from Chapter 10.)
   NMSCH11.ARC      (  ... from Chapter 11.)
   EXTRAS.ARC       (Subsidiary routines, included here to allow 
                       completion of the problems, see below.)
   SAMPLES.ARC      (Sample programs from the text.)
   ARCE.COM         (Executable program to unpack the ARC'ed files. See below.)

To use a routine in Chapter x,  you will need to compile the routines in NMSCHx 
as  well  as  the  routines  in NMSCH00.  Chapter 8 also requires NMSCH03,  and 
Chapter 5 requires NMSCH10.  

Some  people  will  find  it convenient to merge the contents of all the files, 
after compilation, into a `library,' which is a system dependent process.  Many 
of the routines depend on each other,  especially with  respect  to  the  lower 
level utilities, so a library is the easiest way to access everything.  


Squeezing so much high quality software onto one 360K disk required some
compromises. Here is how we did it.
  
(1) Files were compressed using a special utility.  To  unpack 
    you must use another utility, ARCE.COM, as follows: 
     IF YOU HAVE A HARD DISK
        (a) Copy ARCE.COM and any ARC file you want, for example NMSCH08.ARC,
                onto the hard disk, then move to that disk.
        (b) Type ARCE NMSCH08
            This will extract all the files from NMSCH08.ARC. You may then 
                delete NMSCH08.ARC from the hard disk. 
     IF YOU HAVE TWO FLOPPY DISK DRIVES BUT NO HARD DISK
        (a) Place this diskette in drive A: and an empty formatted diskette
            in drive B:. Copy ARCE.COM from A: to B: and then move to B:
        (b) Type ARCE A:NMSCH08     (or any other ARC file on A:)
            This extracts all the files from NMSCH08.ARC and places them on B:.


(2) All the routines from the text have machine readable documentation  in  the 
form  of embedded PROLOGUES.  Many of these routines are part of more extensive 
collections.  Subsidiary routines have sometimes been condensed, and if unused, 
removed.  It is not necessary  to  call  (directly)  any  of  these  subsidiary 
routines.  All  the  problems  in  this  text  can be solved with the top level 
routines.  To get complete versions of the software, see below.  

 
(3) Error processing is done through the XERROR package (Section 5  of  Chapter 
1)  included  here  in simplified form.  All error output is sent to the user's 
terminal.  You probably will never need the complete version,  however  to  get 
the complete version, see below.  

The file MACHCON.FOR in NMSCH00.ARC contains machine dependent information, see 
Section 3 of Chapter 2.  If you are going to use these routines on an IBM PC or 
compatible  don't  do anything to this file.  If you intend to move the Fortran 
source to another  computer  you  may  have  to  modify  it  slightly.  Machine 
constants for several other popular computers are listed in the file.  If yours 
are not please contact us and we  will  try  to  help  you  get  the  necessary 
information.  

  Contents of the file EXTRAS.ARC (9 files)
  Name          Where Referenced
  ============  ================
  BESI0         Problem P9-4. Also includes a routine for exponentially scaled 
                  I0 Bessel function. Some subsidiary routines in the next
                  file (BESJ) are needed too.
  BESJ          Problem P7-2. Also includes routines for Y Bessel functions, 
                  Airy functions, log Gamma and Gamma functions.
  CO2.DAT       Problem P6-8, P9-10
  ELNINO.DAT    Sample program AUTOCOR.EX (Example 11.6) and Problem P11-11 
  ERF.FOR       Problem P1-1 and other places
  QAGI-TST.FOR  Chapter 5 Section 9 
  REACTOR.FOR   Problem P10-11
  SSVDC-TS.FOR  Chapter 6 Sections 8-8.2
  SUNSPOT.DAT   Problem P11-12


Note about the SAMPLES.ARC file, containing all the examples that are listed in 
the  text.  To  make these programs more useful we have modified them to print, 
for reference,  the results that we obtained on an IBM PC/AT.  You can run them 
on  your  own  computer and directly compare your results with those.  In a few 
cases we have  also  abbreviated  the  output  by  commenting  out  some  WRITE 
statements.  One  routine  (Example  11.8)  requires plotting software which is 
system  dependent  and  not  included.  Write  to  us  for  suggestions  as  to 
appropriate plotting routines that can be used on your system.  

We can provide complete copies of all the routines,  (including the lower level 
routines)  on  either  a  high density (1.2MB) 5.25 inch floppy, a high density 
(1.44MB) 3.5 inch  hard-floppy,  or a  Macintosh  diskette.  Similarly  we  can 
provide  double  precision  versions of the software.  For the current handling 
charges contact 

Professor Stephen Nash             or   Dr. David Kahaner
Operations Research and                 Center for Applied Mathematics
   Applied Statistics Department        National Bureau of Standards
George Mason University                 Room A151, Technology Building
Fairfax, VA 22030, U.S.A.               Gaithersburg, MD 20899, U.S.A.

(END OF READ-ME.NMS)