Math::RngStream - Perl wrapper for the RngStreams library
use Math::RngStream; my $rs = Math::RngStream->new; my $n = $rs->rand; my $int = $rs->rand_int(10, 20);
This module wraps the RngStreams library, a package for generating multiple independent streams of pseudo-random numbers.
This package has an object oriented interface:
Sets the initial seed of the package RngStreams to the six integers passed as arguments.
This will be the seed (initial state) of the first stream. If this procedure is not called, the default initial seed is (12345, 12345, 12345, 12345, 12345, 12345).
The first 3 values of the seed must all be less than 4294967087, and not all 0; and the last 3 values must all be less than 4294944443, and not all 0.
Creates a new stream with identifier $name.
its seed is equal to the initial seed of the package given by set_package_seed if this is the first stream created, otherwise it is Z steps ahead of that of the most recently created stream.
Reinitializes the stream to its initial state.
Reinitializes the stream to the beginning of its current substream.
Reinitializes the stream to the beginning of its next substream.
If $anti!=0, the stream will start generating antithetic variates, i.e., 1-U instead of U, until this method is called again with $anti=0.
By default, the streams are created with $anti=0.
After calling this procedure with $incp != 0, each call (direct or indirect) to method rand will advance the state of the stream by 2 steps instead of 1, and will return a number with (roughly) 53 bits of precision instead of 32 bits.
rand
Sets the initial seed of the stream. The arguments must satisfy the same conditions as for method set_package_seed.
set_package_seed
Usage of this method is discouraged!
Advances the state of stream by $k values, without modifying the states of other streams, nor the values of Bg and Ig associated with this stream. If $e>0, then $k=2^$e+$c; if $e<0, then $k=-2^-$e+$c; and if $e=0, then $k=$c. Note: $c is allowed to take negative values.
Returns the current state of the stream. This is convenient if we want to save the state for subsequent use.
Returns a (pseudo)random number from the uniform distribution over the interval (0,1), after advancing the state by one step. The returned number has 32 bits of precision in the sense that it is always a multiple of 1/(2^32-208), unless set_increased_precis has been called for this stream.
set_increased_precis
Returns a (pseudo)random number from the discrete uniform distribution over the integers ($low, $low+1, ..., $high). Makes one call to method rand_u01.
rand_u01
RngStreams website and documentation: http://statmath.wu-wien.ac.at/software/RngStreams/
Before installing this module, you have to download, compile and install the RngStreams library available from its website.
Then, you have to follow the standard Perl module installation procedure:
perl Makefile.PL make make test make install
Or if you have installed the C library in a non standard place:
perl Makefile.PL \ RNGSTREAMS_INCLUDE=/path/to/rngstreams/include \ RNGSTREAMS_LIB=/path/to/rngstreams/lib make make test make install
Copyright (C) 2008 by Salvador Fandino (sfandino@yahoo.com)
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.
This module documentation is based on the RngStreams original documentation Copyright (C) 2003 Pierre L'Ecuyer, DIRO, University of Montreal.
The RngStreams library is distributed under the GPL. Copyright (C) 2003 Pierre L'Ecuyer, DIRO, University of Montreal.
To install Math::RngStream, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Math::RngStream
CPAN shell
perl -MCPAN -e shell install Math::RngStream
For more information on module installation, please visit the detailed CPAN module installation guide.