random_MT32_table_get

Retrieves the current table used in the 32-bit Mersenne Twister generator.

Synopsis

#include <imsls.h>

void imsls_random_MT32_table_get (unsigned int **table, ..., 0)

Required Arguments

unsigned int **table (Output)
Address of a pointer to an array of length 625 containing the table used in the 32-bit Mersenne Twister generator. Typically, unsigned int *table is declared and &table is used as an argument.

Synopsis with Optional Arguments

#include <imsls.h>

void imsls_random_MT32_table_get (int **table,
IMSLS_RETURN_USER, int r[],
0)

Optional Arguments

IMSLS_RETURN_USER, int r[] (Output)
User-supplied array of length 625 containing the table used in the 32-bit Mersenne Twister generator.

Description

The values in table contain the state of the 32-bit Mersenne Twister random number generator. The table can be used by imsls_random_MT32_table_set to set the generator back to this state.

Example

In this example, four simulation streams are generated. The first series is generated with the seed used for initialization. The second series is generated using an array for initialization. The third series is obtained by resetting the generator back to the state it had at the beginning of the second stream. Therefore, the second and third streams are identical. The fourth stream is obtained by resetting the generator back to its original, uninitialized state, and having it reinitialize using the seed. The fourth and first streams are therefore the same.

 

#include <imsls.h>

 

int main()

{

unsigned int init[] = {0x123, 0x234, 0x345, 0x456};

float *r;

int iseed = 123457;

int *itable;

int nr = 5;

 

/* Initialize Mersenne Twister series with a seed */

imsls_random_option (8);

imsls_random_seed_set (iseed);

r = imsls_f_random_uniform (nr, 0);

imsls_f_write_matrix ("First stream output", 1, 5, r,

IMSLS_NO_COL_LABELS,

IMSLS_NO_ROW_LABELS,

0);

imsls_free(r);

 

/* Reinitialize Mersenne Twister series with an array */

imsls_random_option (8);

imsls_random_MT32_init(4, init);

/* Save the state of the series */

imsls_random_MT32_table_get(&itable, 0);

 

r = imsls_f_random_uniform (nr, 0);

imsls_f_write_matrix ("Second stream output", 1, 5, r,

IMSLS_NO_COL_LABELS,

IMSLS_NO_ROW_LABELS,

0);

imsls_free(r);

 

/* Restore the state of the series */

imsls_random_MT32_table_set(itable);

 

r = imsls_f_random_uniform (nr, 0);

imsls_f_write_matrix ("Third stream output", 1, 5, r,

IMSLS_NO_COL_LABELS,

IMSLS_NO_ROW_LABELS,

0);

imsls_free(r);

 

/* Reset the series - it will reinitialize from the seed */

itable[0] = 1000;

imsls_random_MT32_table_set(itable);

 

r = imsls_f_random_uniform (nr, 0);

imsls_f_write_matrix ("Fourth stream output", 1, 5, r,

IMSLS_NO_COL_LABELS,

IMSLS_NO_ROW_LABELS,

0);

imsls_free(r);

return 0;

}

Output

 

                     First stream output

    0.4347       0.3522       0.0139       0.2091       0.4956

 

                    Second stream output

    0.2486       0.2226       0.1111       0.9563       0.9846

 

                     Third stream output

    0.2486       0.2226       0.1111       0.9563       0.9846

 

                    Fourth stream output

    0.4347       0.3522       0.0139       0.2091       0.4956