RandStream.create - Create random number streams

Class

RandStream

Syntax

[s1,s2,...] = RandStream.create('gentype','NumStreams',n)
s = RandStream.create('gentype')
[ ... ] = RandStream.create('gentype', Name, Value,...)

Description

[s1,s2,...] = RandStream.create('gentype','NumStreams',n) creates n random number streams that use the uniform pseudorandom number generator algorithm specified by gentype. The streams are independent in a pseudorandom sense. The streams are not necessarily independent from streams created at other times. RandStream.list returns all possible values for gentype or see Choosing a Random Number Generator in the MATLAB Mathematics documentation for details on generator algorithms.

Note   Multiple streams are not supported by all generator types. Use either the multiplicative lagged Fibonacci generator (mlfg6331_64) or the combined multiple recursive generator (mrg32k3a) to create multiple streams.

s = RandStream.create('gentype') creates a single random stream. The RandStream constructor is a more concise alternative when you need to create a single stream.

[ ... ] = RandStream.create('gentype', Name, Value,...) allows you to specify optional Name, Value pairs to control creation of the stream. The parameters are:

Examples

Create three independent streams.

[s1,s2,s3] = RandStream.create('mrg32k3a','NumStreams',3);
r1 = rand(s1,100000,1); r2 = rand(s2,100000,1); r3 = rand(s3,100000,1);
corrcoef([r1,r2,r3])

Create one stream from a set of three independent streams and designate it as the global stream.

s2 = RandStream.create('mrg32k3a','NumStreams',3,'StreamIndices',2);
RandStream.setGlobalStream(s2);

See Also

RandStream | RandStream.list