Chapter 12: Random Number Generation

random_table_get

Retrieves the current table used in the shuffled generator.

Synopsis

#include <imsls.h>

void  imsls_f_random_table_get (float **table, ..., 0)

The type double function is imsls_d_random_table_get.

Required Arguments

float **table   (Output)
Address of a pointer to an array of length 128 containing the table used in the  shuffled generators. Typically,  float *table is  declared and &table is used as an argument.

Synopsis with Optional Arguments

#include <imsls.h>

void imsls_f_random_table_get (float **table,
IMSLS_RETURN_USER, float r[],
 0)

Optional Arguments

IMSLS_RETURN_USER, float r[]   (Output)
User-supplied array of length 1565 containing the table used in the  GFSR generators.

Description

The values in table are initialized by the IMSL random number generators. The values are all positive except if the user wishes to reinitialize the array, in which case the first element of the array is input as a nonpositive value. (Usually, one should avoid reinitializing these arrays, but it might be necessary sometimes in restarting a simulation.) If the first element of table is set to a nonpositive value on the call to imsls_random_table_set, on the next invocation of a routine to generate random numbers using a shuffled method , the appropriate array will be reinitialized.

Example

See function imsls_random_GFSR_table_get.


Visual Numerics, Inc.
Visual Numerics - Developers of IMSL and PV-WAVE
http://www.vni.com/
PHONE: 713.784.3131
FAX:713.781.9260