            Readme File For Disk Accompanying LLDRLF Paper

This disk is in DOS format (1.44MB) and contains 5 files.


                               CONTENTS

readme.dsk: this file.

src.f contains the complete source code for LLDRLF including the
double precision version of BRATIO.

driver1.f contains the source code for a test program that makes the
calculations of LLDFLF on a set of A, B, and W values.

RES1 contains the output from driver1.f  run on an IBM RS6000/550.
The output was obtained using all defaults, i.e., the user specifies
neither W nor A nor B.

driver2.f contains  the main program, tstlld,  that runs all test cases
described   in the paper.   This program  replaces program, tstsht, in
driver1.f.  The  results of the full  test run consumes  about  7 MB of
disk.

                             PORTABILITY

The only machine dependent code in src.f is in BRATIO which was
previously published by TOMS.  The test programs also use widely
distributed machine specific routines listed below.

src.f  and driver1.f have  been   run on  both  an  IBM RS6000 and  a
Solbourne   machine.  The code   has been examined  for portability by
FTNCHEK V. 2.7.


                             INSTALLATION

(1) Machine dependent constants.  Routines:

         INTEGER FUNCTION ipmpar                        in LLDRLF.F

         INTEGER FUNCTION i1mach                        in TSTLLD.F

         DOUBLE PRECISION FUNCTION d1mach               in TSTLLD.F

         REAL FUNCTION r1mach                           in TSTLLD.F

   all return   machine dependent constants.   Appropriate  values for
   various machines appear in these routines  as comments.  The values
   in the distributed version are IEEE  which is appropriate for MSDOS
   machines, Apple Macintosh,  and  most UNIX workstations.  For   any
   other machine uncomment the appropriate values.

   Routine spmpar  in LLDRLF has     been modified to  return   double
   precision  machine dependent   constants.  The  user  need take  no
   action even though the comments specify single precision.


(2) Compile and link the code in src.f and driver1.f into an
    executable object.  

----------------------------------------------------------------------

              DOCUMENTATION FOR TEST PROGRAM FOR LLDRLF

This is an annotated run of the test program.

tstlld
 Do you want to output to a file? (y/n)
$? 
n

<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

If 'y' is selected, program will prompt for a file name
and write all results to the selected file.

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>

 Do you want to specify A and B? (y/n)
$? 
n

<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

If not, A and B will take on all combinations of the following
powers of 10:
    -3
     1
     5
    10

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>

 Do you want to specify W? (y/n)
$? 
y

<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

W is the argument of the log-F distribution and is specified in units
of the standard deviation of that distribution.  If a particular value
is not specified, W will range over the values:

-1000 -500 -100 -50 -10 -5 -1 0
and back from 1 to 1000 using the same absolute values.

If none of A, B, or W is specified all combinations are taken as per
the sample output.

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>


 Enter W (in standard deviations).
$? 
1

<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

W has been specified but not A and B which range over
the values given above.  As each answer is printed to the
screen, the display pauses pending a CR.  (When answers
are written to a file, there is no pause.)

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>

 ++++++++++++++++++++++++++++++++++++++++++++++++++
 ------------------ Values Used -------------------
 A: 1.0000E-03
 B: 1.0000E-03
 Standard Deviation:  1414.2147
 **************************************************
     W (in standard deviations)      1.0000
     log(f(exp(W)|DFN,DFD))      -5.2146643110562865E+00
               First Derivative  -1.0000000000000000E-03
              Second Derivative   0.0000000000000000E+00
     log(F(exp(W)|DFN,DFD))      -1.2960587976738849E-01
               First Derivative   1.3837963645320079E-04
              Second Derivative  -1.5752856023812081E-07
     log(1 - F(exp(W)|DFN,DFD))  -2.1073602618451908E+00
               First Derivative  -1.0000000000000000E-03
              Second Derivative   0.0000000000000000E+00
 Press Return / Enter to continue:
$? 

 ++++++++++++++++++++++++++++++++++++++++++++++++++
 ------------------ Values Used -------------------
 A: 1.0000E-03
 B: 1.0000E+01
 Standard Deviation:  1000.0009
 **************************************************
     W (in standard deviations)      1.0000
     log(f(exp(W)|DFN,DFD))      -9.9113563342173002E+03
               First Derivative  -1.0000000000000000E+01
              Second Derivative   0.0000000000000000E+00
     log(F(exp(W)|DFN,DFD))       0.0000000000000000E+00
               First Derivative   0.0000000000000000E+00
              Second Derivative   0.0000000000000000E+00
     log(1 - F(exp(W)|DFN,DFD))  -9.9171128469472860E+03
               First Derivative  -1.0000000000000000E+01
              Second Derivative   0.0000000000000000E+00

<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

Numerous lines of output deleted.

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>


 ++++++++++++++++++++++++++++++++++++++++++++++++++
 ------------------ Values Used -------------------
 A: 1.0000E+10
 B: 1.0000E+10
 Standard Deviation: 1.4142E-05
 **************************************************
     W (in standard deviations)      1.0000
     log(f(exp(W)|DFN,DFD))      -1.4189385332380060E+00
               First Derivative  -7.0710678119243981E+04
              Second Derivative  -4.9999999997500000E+09
     log(F(exp(W)|DFN,DFD))      -1.7275377902009820E-01
               First Derivative   2.0336388971268665E+04
              Second Derivative  -1.8515685710458596E+09
     log(1 - F(exp(W)|DFN,DFD))  -1.8410216450030916E+00
               First Derivative  -1.0784334959763364E+05
              Second Derivative  -4.0045116717191434E+09
 Press Return / Enter to continue:
$? 

 Do you want to continue? (y/n)
$? 
y
<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

A 'y' starts over and a 'n' exits the program.  Here is an example in
which A and B are specified but not W.

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>
 Do you want to specify A and B? (y/n)
$? 
y
 Enter A.
$? 
10
 Enter B.
$? 
10
 Do you want to specify W? (y/n)
$? 
n
 ++++++++++++++++++++++++++++++++++++++++++++++++++
 ------------------ Values Used -------------------
 A: 1.0000E+01
 B: 1.0000E+01
 Standard Deviation:      .4586
 **************************************************
     W (in standard deviations)  -1000.0000
     log(f(exp(W)|DFN,DFD))      -4.5732724904619372E+03
               First Derivative   1.0000000000000000E+01
              Second Derivative  -1.3326648884764100-198
     log(F(exp(W)|DFN,DFD))      -4.5747703565987140E+03
               First Derivative   1.0000000000000000E+01
              Second Derivative  -1.2115135349785545-198
     log(1 - F(exp(W)|DFN,DFD))   0.0000000000000000E+00
               First Derivative   0.0000000000000000E+00
              Second Derivative   0.0000000000000000E+00
 Press Return / Enter to continue:
$? 
<<<<<<<<<<<<<<<<<<<< BEGIN ANNOTATION >>>>>>>>>>>>>>>>>>>>

Numerous lines of output deleted.

<<<<<<<<<<<<<<<<<<<< END ANNOTATION >>>>>>>>>>>>>>>>>>>>

 **************************************************
     W (in standard deviations)   1000.0000
     log(f(exp(W)|DFN,DFD))      -4.5732724904619372E+03
               First Derivative  -1.0000000000000000E+01
              Second Derivative  -1.3326648884764100-198
     log(F(exp(W)|DFN,DFD))       0.0000000000000000E+00
               First Derivative   0.0000000000000000E+00
              Second Derivative   0.0000000000000000E+00
     log(1 - F(exp(W)|DFN,DFD))  -4.5747703565987140E+03
               First Derivative  -1.0000000000000000E+01
              Second Derivative  -1.2115135349785545-198
 Press Return / Enter to continue:
$? 

 Do you want to continue? (y/n)
$? 
n
