Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

reset (RandStream)

Reset random number stream

Syntax

reset(s)
reset(s,seed)

Description

reset(s) resets the generator for the random stream, s, to the internal state corresponding to its seed. This is similar to clearing s and recreating it using RandStream(Type,...), except that reset does not set the stream's NormalTransform, Antithetic, and FullPrecision properties to their original values.

reset(s,seed) resets the generator for the random stream, s, to the internal state corresponding to seed (the seed value), and it updates the seed property of s. The value of seed must be an integer between 0 and 232 − 1. Resetting a stream's seed can invalidate independence with other streams.

    Note:   Resetting a stream should be used primarily for reproducing results.

Examples

Example 1

Reset a random number stream to its initial state. This does not create a random number stream, it simply resets the stream:

stream = RandStream('twister','Seed',0)
stream = 

mt19937ar random stream
             Seed: 0
  NormalTransform: Ziggurat
reset(stream);
stream.Seed
ans =

           0

Example 2

Reset a random number stream using a specific seed:

stream = RandStream('twister','Seed',0)
stream = 

mt19937ar random stream
             Seed: 0
  NormalTransform: Ziggurat
reset(stream,1);
stream.Seed
ans =

           1

Was this topic helpful?