modules/Math-Random/README

   1 Math::Random -- Random number generators
   2
   3 This module generates a variety of random numbers.  Capabilities
   4 of wide interest include the generation of:
   5     uniform numbers between 0 and 1 (or user chosen boundaries)
   6     random integers between user specified bounds
   7     random permutations of a list (shuffle a deck of cards)
   8
   9 The starting value for the random number generators can be specified
  10 as a phrase.  The user's name would make the value easy to remember.
  11 Of course, the Perl time function can be used to provide a
  12 pseudo-random starting value.
  13
  14 Also included in the package are generators for a large number of
  15 distributions known primarily to statisticians.  These include the
  16 normal, exponential, binomial, beta, gamma, t, F, and others.
  17
  18 THE GOOD NEWS.  The generators are taken from published sources, are
  19 of high quality, and are largely machine independent.  We say "largely"
  20 because different machines handle floating point somewhat differently,
  21 so values may differ slightly.  The integer calculations (random
  22 integers and permutations) should be the same from machine to machine.
  23
  24 Devotees of Donald Knuth will be reassured to know that many of the
  25 algorithms used here are mentioned favorably in his treatment of
  26 random numbers.  See The Art of Computer Programming, vol. 2 (Semi-
  27 numerical Algorithms), 3rd edition (Reading, Mass.: Addison-Wesley,
  28 1997), pp. 106-108 (Table 1, line 21), 129-137.
  29
  30 THE BAD NEWS.  We adapted or modified many routines published in the
  31 ACM's Transactions on Mathematical Software.  The ACM has copyright on
  32 these routines (see the ACM statement on software policy in the POD/man
  33 page).  Commercial incorporation of these routines into products to be
  34 sold requires permission and perhaps payment to the ACM.  But if you
  35 don't plan to sell them, enjoy.  (Note, however, that algorithms per se
  36 cannot be copyrighted; see 17 USC 102(b).)
  37
  38
  39 How to Install
  40 ==============
  41
  42 The usual:
  43
  44   perl Makefile.PL
  45   make
  46   make test
  47   make install
  48
  49
  50 Who Deserves the Credit?  And Who Deserves the Blame?
  51 =====================================================
  52
  53 Math::Random was put together by John Venier and Barry W. Brown
  54 with help from SWIG.  For version 0.61, Geoffrey Rommel made various
  55 cosmetic changes.
  56
  57 Correspondence regarding Math::Random or randlib should be
  58 addressed to John Venier by email to
  59
  60                       venier@odin.mdacc.tmc.edu
  61
  62 Our address is:
  63
  64                 Department of Biomathematics, Box 237
  65          The University of Texas, M.D. Anderson Cancer Center
  66                        1515 Holcombe Boulevard
  67                           Houston, TX 77030
  68
  69 May 1999