rndStateSkip#

Purpose#

To advance a state vector by a specified number of values.

Format#

newState = rndStateSkip(numSkip, state)#

Parameters:

numSkip (scalar) – the number of values to skip.
state (vector) – opaque state vector

Returns:

newState (Opaque vector) – the advanced state.

Examples#

seed = 9192834;

// Create a state from the 118th substream of the
// Wichmann-Hill RNG
state = rndCreateState("wh-118", seed);

// Create a new state that is advanced by 2 numbers.
newState = rndStateSkip(2, state);

// Create and compare numbers from the two state vectors
{ r, state } = rndu(4, 1, state );
{ r2, newState } = rndu(2, 1, newState);

     0.54973563
r =  0.81642451
     0.68583300
     0.09105558

r2 = 0.68583300
     0.09105558

Technical Notes#

This function applies ONLY to the MRG32K3A and Wichmann-Hill random number generators.