naginterfaces.library.rand.int_​uniform

naginterfaces.library.rand.int_uniform(n, a, b, statecomm)

int_uniform generates a vector of pseudorandom integers uniformly distributed over the interval $[a,b]$.

For full information please refer to the NAG Library document for g05tl

https://support.nag.com/numeric/nl/nagdoc_30/flhtml/g05/g05tlf.html

Parameters

nint

$n$, the number of pseudorandom numbers to be generated.

aint

The end points $a$ and $b$ of the uniform distribution.

bint

The end points $a$ and $b$ of the uniform distribution.

statecommdict, RNG communication object, modified in place

RNG communication structure.

This argument must have been initialized by a prior call to init_repeat() or init_nonrepeat().

Returns

xint, ndarray, shape $\left(n\right)$

The $n$ pseudorandom numbers from the specified uniform distribution.

Raises

NagValueError

(errno $1$)

On entry, $n=⟨value⟩$.

Constraint: $n\ge 0$.

(errno $3$)

On entry, $a=⟨value⟩$ and $b=⟨value⟩$.

Constraint: $b\ge a$.

(errno $4$)

On entry, $statecomm$[‘state’] vector has been corrupted or not initialized.

Notes

int_uniform generates the next $n$ values $y_i$ from a uniform $(0,1]$ generator (see dist_uniform01() for details) and applies the transformation

$$x_i=a+\lfloor (b-a+1)y_i\rfloor \text{,}$$

where $\lfloor z\rfloor$ is the integer part of the real value $z$. The function ensures that the values $x_i$ lie in the closed interval $[a,b]$.

One of the initialization functions init_repeat() (for a repeatable sequence if computed sequentially) or init_nonrepeat() (for a non-repeatable sequence) must be called prior to the first call to int_uniform.

References

Knuth, D E, 1981, The Art of Computer Programming (Volume 2), (2nd Edition), Addison–Wesley