numpy.random.set_state¶
-
numpy.random.
set_state
(state)¶ Set the internal state of the generator from a tuple.
For use if one has reason to manually (re-)set the internal state of the “Mersenne Twister”[R270] pseudo-random number generating algorithm.
Parameters: state : tuple(str, ndarray of 624 uints, int, int, float)
The state tuple has the following items:
- the string ‘MT19937’, specifying the Mersenne Twister algorithm.
- a 1-D array of 624 unsigned integers
keys
. - an integer
pos
. - an integer
has_gauss
. - a float
cached_gaussian
.
Returns: out : None
Returns ‘None’ on success.
See also
Notes
set_state
andget_state
are not needed to work with any of the random distributions in NumPy. If the internal state is manually altered, the user should know exactly what he/she is doing.For backwards compatibility, the form (str, array of 624 uints, int) is also accepted although it is missing some information about the cached Gaussian value:
state = ('MT19937', keys, pos)
.References
[R270] (1, 2) M. Matsumoto and T. Nishimura, “Mersenne Twister: A 623-dimensionally equidistributed uniform pseudorandom number generator,” ACM Trans. on Modeling and Computer Simulation, Vol. 8, No. 1, pp. 3-30, Jan. 1998.