home *** CD-ROM | disk | FTP | other *** search
/ Los Alamos National Laboratory / LANL_CD.ISO / software / slatec / readme.txt < prev    next >
Encoding:
Text File  |  1992-10-16  |  3.6 KB  |  88 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.             ********** SLATEC Common Mathematical Library **********
  9.  
  10.                                   Version 4.0-
  11.  
  12.                   October, 1992
  13.  
  14.  
  15.  
  16.  source
  17.  
  18.  This file contains the main SLATEC Fortran source of 1,078 routines.  The
  19.  subprograms are in alphabetical order with an *DECK (name) record as the first
  20.  record of each subprogram.  This *DECK record is compatible with the CDC and
  21.  Cray update processors and the Opcode, Inc. HISTORIAN utility;  it could be
  22.  used as a search string for editing the file on other machines.  The first deck
  23.  is named AAAAAA and contains the SLATEC disclaimer.
  24.  
  25.  There are five (5) machine specific subprograms (D1MACH, I1MACH, R1MACH, FDUMP
  26.  and XERHLT) in the source file.  These are described further in the next two
  27.  paragraphs.
  28.  
  29.  Machine constants, such as word length and maximum positive exponent, are
  30.  supplied to routines in SLATEC source via the functions D1MACH, I1MACH and
  31.  R1MACH.  Make sure that each machine type at your site returns the correct
  32.  values for these functions.  In most cases, this only requires replacing a "C"
  33.  with a blank in the first column of several lines of each function.  The copies
  34.  of D1MACH, I1MACH and R1MACH included in the source have all the machine
  35.  specific constants commented out with a "C" in column one.
  36.  
  37.  The standard error handler has two machine dependent subroutines in it: FDUMP
  38.  and XERHLT.  The routine XERHLT is called via XERMSG when a fatal error is
  39.  encountered and must terminate the job.  The copy of XERHLT included in this
  40.  file contains a "STOP" and thus does stop execution.  However, in most
  41.  circumstances, this normal exit is unacceptable when an error has been detected
  42.  and this subroutine should be replaced at each site.  The routine FDUMP is
  43.  called via XERMSG when traceback information is desired.  This routine should
  44.  provide the traceback information to appropriate output files.  The copy of
  45.  FDUMP included in the source does not produce traceback information.  If this
  46.  function is desired, it must be implemented at each site.
  47.  
  48.  It is assumed that all ANSI-77 standard intrinsic functions are vendor-supplied
  49.  and, therefore, are not included in the main SLATEC source.  In the event that
  50.  some of these subprograms are not resident on the system (e.g. DINT on CDC),
  51.  many are included in the subsidiary programs, file 14.  In some cases, the
  52.  higher special functions (e.g. error functions, Bessel functions) anticipate
  53.  that certain errors will be handled in the intrinsic functions.  This may not
  54.  be done appropriately in vendor-supplied intrinsic functions and may cause
  55.  difficulties.
  56.  
  57.  
  58.  quick_checks
  59.  
  60.  This file contains the SLATEC quick checks.  There are thirty eight (38)
  61.  quick check drivers.
  62.  
  63.  If some of the quick checks fail on certain machines, it does not necessarily
  64.  indicate a problem in the source, but possibly in the quick checks themselves,
  65.  or the machine architecture or the operating system or the compiler or vendor
  66.  or user supplied software.
  67.  
  68.  Please note the following comments concerning this file and its contents.
  69.  
  70.    1. The thirty eight (38) main programs (quick check drivers) are
  71.       separated from the quick check subprograms.  An *DECK (name)
  72.       record was placed before each main program.  The deck names are
  73.       DECK0, DECK1, ... ,DECK37.
  74.  
  75.    2. An *DECK (name) was placed before each test subprogram.  The
  76.       test subprograms are arranged in alphabetical order.
  77.  
  78.  On the VAX under VMS, the quick checks should be run with KPRINT = 0 or 1 (zero
  79.  or one).
  80.  
  81.  
  82.  guide
  83.  
  84.  This file contains a copy of the latest version of the document "Guide to the
  85.  SLATEC Common Mathematical Library."
  86.  
  87.  
  88.