Math-Random-MT-Auto version 4.10.00
===================================

This module provides pseudorandom number generators (PRNGs) that are based
on the Mersenne Twister algorithm.  There is a functional interface to a
single, standalone PRNG, and an OO interface (based on the inside-out object
model) for generating multiple PRNG objects.

The PRNGs are self-seeding, automatically acquiring a (19968-bit) random
seed from user-selectable sources.  Seed sources include local random
devices (/dev/random and /dev/urandom), Internet sources (random.org and
HotBits), and Win32 XP system random data.  Users may also provide their
own seed sources.

In addition to integer and floating-point uniformly-distributed random number
deviates, this module implements the following non-uniform deviates as found
in 'Numerical Recipes in C':
    Gaussian (normal)
    Exponential
    Erlang (gamma of integer order)
    Poisson
    Binomial

This module also provides a function/method for shuffling data based on the
Fisher-Yates shuffling algorithm.

This module is thread-safe with respect to its OO interface for Perl v5.7.2
and beyond.  (The standalone PRNG is not thread-safe.)

For Perl compiled to support 64-bit integers, this module will use a 64-bit
version of the Mersenne Twister algorithm, thus providing 64-bit random
integers (and 53-bit random doubles).  (32-bits otherwise.)

The code for this module has been optimized for speed.  Under Cygwin, it's
2.5 times faster than Math::Random::MT, and under Solaris, it's more than
four times faster.  (Math::Random::MT fails to build under Windows.)

INSTALLATION

A 'C' compiler is required for building this module.

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

Requires Perl 5.6.0 or later.

This module uses the following 'standard' modules:

  attributes
  Carp
  Scalar::Util          - Standard in 5.8; obtain from CPAN if necessary
  Dynaloader
  ExtUtils::MakeMaker   - For installation
  File::Spec            - For installation
  Test::More            - For installation

To utilize the option of acquiring seed data from Internet sources,
the following module is needed:

  LWP::UserAgent

On Windows XP, to utilize the option of acquiring seed data from
the system's random data source, the following module is needed:

  Win32::API

COPYRIGHT AND LICENCE

A C-Program for MT19937 (32- and 64-bit versions), with initialization
improved 2002/1/26.  Coded by Takuji Nishimura and Makoto Matsumoto,
and including Shawn Cokus's optimizations.

Copyright (C) 1997 - 2004, Makoto Matsumoto and Takuji Nishimura,
All rights reserved.
Copyright (C) 2005, Mutsuo Saito, All rights reserved.
Copyright 2005 Jerry D. Hedden <jdhedden AT 1979 DOT usna DOT com>

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.

3. The names of its contributors may not be used to endorse or promote
   products derived from this software without specific prior written
   permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Any feedback is very welcome.
<m-mat AT math DOT sci DOT hiroshima-u DOT ac DOT jp>
http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html

# EOF
