The NewGenerator command outputs a Maple procedure, a pseudo-random number generator, which when called outputs one pseudo-random integer. The output of the generator depends on the options described below. The default is to output integers on the range $0..999999999999$, i.e., a random 12 digit integer.

The returned procedure calls the MersenneTwister algorithm to generate the numbers.  Although you can have multiple generating procedures, they all share the same state.  This means that calling one procedure will effect the numbers returned by another.

The following optional arguments are supported. They are input as equations in any order.

range=integer..integer or integer

If the value of the range argument is a range, then the integer will be chosen from that range.  If the value of the range argument is an integer, then the integer will be take from the range [0..value).  The default range is $1000000000000$.

If one only needs to generate a small number of integers then the GenerateInteger function can be used.  However, using a procedure returned by NewGenerator is faster than calling GenerateInteger multiple times.

$\mathrm{with}\left(\mathrm{RandomTools}\left[\mathrm{MersenneTwister}\right]\right)$

$\left[\mathrm{GenerateData}\,\mathrm{GenerateFloat}\,\mathrm{GenerateFloat64}\,\mathrm{GenerateInteger}\,\mathrm{GenerateInteger32}\,\mathrm{GenerateUnsignedInt32}\,\mathrm{GetState}\,\mathrm{NewGenerator}\,\mathrm{SetState}\right]$

$M≔\mathrm{NewGenerator}\left(\mathrm{range}=1..6\right)$

$M≔\mathbf{proc}\left(\right)\mathbf{proc}\left(\right)\mathbf{option}\mathrm{builtin}\=\mathrm{RandNumberInterface}\;\mathbf{end\; proc}\left(6\,6\,3\right)\+1\mathbf{end\; proc}$

$M\left(\right)$

$5$

$\mathrm{seq}\left(M\left(\right)\,i=1..10\right)$

$2,5,6,2,3,4,4,6,5,3$

$M≔\mathrm{NewGenerator}\left(\mathrm{range}={10}^{10}\right)$

$M≔\mathbf{proc}\left(\right)\mathbf{proc}\left(\right)\mathbf{option}\mathrm{builtin}\=\mathrm{RandNumberInterface}\;\mathbf{end\; proc}\left(6\,10000000000\,34\right)\mathbf{end\; proc}$

$M\left(\right)$

$8451185402$

$\mathrm{seq}\left(M\left(\right)\,i=1..5\right)$

$7412421905,9061787218,3427838553,1275731771,20544909$

$\mathrm{Float}\left(M\left(\right)\,-10\right)$

$0.4777998714$

$\mathrm{seq}\left(\mathrm{Float}\left(M\left(\right)\,-10\right)\,i=1..5\right)$

$0.8067798189,0.3427077306,0.5205175372,0.7221384230,0.2039073006$

$M≔\mathrm{NewGenerator}\left(\mathrm{range}={10}^{32}\right)\:$

$M\left(\right)$

$82579665362154732179876235348313$