home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / math / ksprob21.zip / KSDOCS.EXE / KSPROB.DOC < prev    next >
Text File  |  1993-05-23  |  7KB  |  152 lines
  1.  
  2.  
  3.                                  ksprob 2.10
  4.  
  5.                                Joseph C. Hudson
  6.                                 4903 Algonquin
  7.                               Clarkston, MI 48348
  8.  
  9.         introduction
  10.  
  11.         ksprob computes probabilities and quantiles for a number of
  12.         distributions. One somewhat novel feature is that quantiles are
  13.         computed for discrete distributions.
  14.  
  15.         I do not offer a warranty or guarantee of any kind for this
  16.         program. I've tried hard to make the output correct, but using
  17.         it with new data sets and different machines may reveal errors
  18.         I'm not aware of. Follow the advice of Gerard E. Dallal
  19.         (Statistical Microcomputing - Like It Is, American Statistician,
  20.         V42 N3 Aug 1988): assume that this program does everything wrong
  21.         until you put it through its paces with difficult input and
  22.         conclude otherwise. Above all, enjoy. If you care to send me a
  23.         brief report about what you like and don't like about this
  24.         program, it would be very much appreciated.
  25.  
  26.         ksprob is copyright (C) 1990-93 Joseph C. Hudson 4903 Algonquin
  27.         Clarkston MI 48348. All rights are reserved.
  28.  
  29.  
  30.         running ksprob
  31.  
  32.         When ksprob starts, the main menu appears:
  33.  
  34.         ┌──────────────────────────────────────────────────────────────┐
  35.         │ ksprob 2.10                                                  │
  36.         │                                                              │
  37.         │ exit  help  dir  viewfile  compute:                          │
  38.         │                                                              │
  39.         │ file name:                                                   │
  40.         │                                                              │
  41.         │ binomial            beta                inverse Gaussian     │
  42.         │ discrete Weibull    Cauchy              Laplace              │
  43.         │ hypergeometric      chi-square          lognormal            │
  44.         │ negative binomial   noncen chi-square   logistic             │
  45.         │ Poisson             largest extr value  normal (Gaussian)    │
  46.         │                     smallst extr value  Pareto               │
  47.         │                     exponential         Rayleigh             │
  48.         │                     F                   Student`s t          │
  49.         │                     noncentral F        noncentral t         │
  50.         │                     gamma (Erlang)      triangular           │
  51.         │                                         Weibull              │
  52.         │                                                              │
  53.         └──────────────────────────────────────────────────────────────┘
  54.  
  55.         Hitting the <Home> key anywhere in the main menu or the <Esc>
  56.         key below the file name: line will move the cursor to <exit>.
  57.         With the cursor on <exit>, hit the x key to exit the program.
  58.  
  59.         ksprob                                                  page 2
  60.  
  61.  
  62.         Output can be written to screen, file or printer. The default
  63.         is to write to screen. To select file or printer, move to <file
  64.         name:> and press <enter>. You will be asked to enter a file name
  65.         or one of LPT1, LPT2 or LPT3. If you enter the name of a file
  66.         that already exists, output will be appended to the end of the
  67.         file. If you enter LPT1,2 or 3, output will be sent to that
  68.         printer port. Most computers with one printer use LPT1 as the
  69.         printer port. You can view the contents of the output file using
  70.         the <viewfile> selection in the main menu.
  71.  
  72.         <dir> will show a disk directory.
  73.  
  74.         ksprob will compute either probabilities (pdf,cdf,rel,haz) or
  75.         inverse cdfs (percentiles, quantiles). You can toggle between
  76.         these at the <compute:> entry in the first menu row. You
  77.         can also toggle between these by hitting the t key while
  78.         in the main body of the menu.
  79.  
  80.         Use the arrow keys to move below the <file name:> selection into
  81.         the distributions area. By putting the cursor on the name of the
  82.         distribution you want and pressing <enter>, you bring up a screen
  83.         that allows you to enter parameters for the distribution and a
  84.         value of the random variable. If the program is set to compute
  85.         probabilities, the default, values of the pdf, cdf, reliability
  86.         and hazard functions are computed. For example, selecting normal
  87.         in the main menu will bring up the heading
  88.  
  89.         normal (Gaussian) distribution
  90.           mu      sigma      x        f(x)     F(x)     R(x)     h(x)
  91.         0.000000 1.000000 1.000000 0.241971 0.841345 0.158655 1.525135
  92.  
  93.         Entering the values shown for mu, sigma and x, the program will
  94.         compute the other numbers. the cursor will go to the next line,
  95.         ready for another computation. The display will scroll when the
  96.         last line used above the help box is reached. The help box gives
  97.         a brief description of the parameters and restrictions on them
  98.         and on x. Hit the Esc key to return to the main menu.
  99.  
  100.         If inverse cdfs is selected, the selecting the normal
  101.         distribution brings up
  102.  
  103.         percentage points of the normal (Gaussian) distribution
  104.               mu        sigma      cdf            x
  105.            0.000000    1.000000  0.950000       1.644854
  106.  
  107.         If you enter mu, sigma and cdf, the program computes x.
  108.         
  109.  
  110.         ksprob                                                  page 3
  111.  
  112.  
  113.         With inverse cdfs, selecting binomial brings up
  114.  
  115.         percentage points of the binomial distribution
  116.            n      p        cdf       x   F(x)       F(x+1)
  117.            20  0.300000  0.950000     8  0.886669   0.952038
  118.            11  0.500000  0.500000     5  0.500000   0.725586
  119.  
  120.         entering 20, .3 and .95, the program finds the largest x for
  121.         which the cdf is less than or equal to .95, in this case 8. The
  122.         cdf values for 8 and 9 are then shown. Sometines there will be
  123.         an exact match, as in the second line of output.
  124.  
  125.         With probabilities selected, the same quantities are computed for
  126.         discrete distributions as for continuous:
  127.  
  128.         binomial distribution
  129.            n      p        x       f(x)      F(x)      R(x)      h(x)
  130.            20  0.300000     8    0.114397  0.886669  0.113331  0.576800
  131.  
  132.         computational notes
  133.  
  134.         The distributions available in ksprob are described in two doc-
  135.         uments: ksprdist.wp and ks.doc. ks.doc gives parameterizations,
  136.         and ksprdist.wp is a wordperfect document giving pdfs, cdfs, mean
  137.         and variance.
  138.  
  139.         For discrete distributions, the hazard function is
  140.  
  141.                         h(x) = f(x+1)/ R(x).
  142.  
  143.         The 80x87 chip is used if present, and is simulated if not
  144.         present. All computations are done with 64 bit reals. If a
  145.         computation cannot be carried out, a missing value is reported.
  146.         For reals, the missing value is the 8087 'infinity'. For any
  147.         other variable type, the missing value is the largest value that
  148.         the type can assume, i.e. 255 for bytes, 32767 for integers,
  149.         65535 for words, 2147483647 for longints.
  150.  
  151.         For references, see ks.doc.
  152.