Generates pseudorandom numbers from a uniform (0, 1) distribution.

Synopsis

#include <imsls.h>

float *imsls_f_random_uniform (int n_random, …, 0)

The type double function is imsls_d_random_uniform.

Required Arguments

int n_random   (Input)
Number of random numbers to generate.

Return Value

An array of length n_random containing the random uniform (0, 1) deviates.

Synopsis with Optional Arguments

#include <imsls.h>

float *imsls_f_random_uniform (int n_random,
IMSLS_RETURN_USER, float r[],
0)

Optional Arguments

IMSLS_RETURN_USER, float r[]   (Output)
User-supplied array of length n_random containing the random uniform (0, 1) deviates.

Description

Function imsls_f_random_uniform generates pseudorandom numbers from a uniform (0, 1) distribution using a multiplicative congruential method. The form of the generator is as follows:

xi ≡ cxi−1mod (231 − 1)

Each xi is then scaled into the unit interval (0, 1). The possible values for c in the generators are 16807, 397204094, and 950706376. The selection is made by the function imsls_random_option. The choice of 16807 will result in the fastest execution time. If no selection is made explicitly, the functions use the multiplier 16807.

Function imsls_random_seed_set can be used to initialize the seed of the random number generator; function imsls_random_option can be used to select the form of the generator.

The user can select a shuffled version of these generators. In this scheme, a table is filled with the first 128 uniform (0, 1) numbers resulting from the simple multiplicative congruential generator. Then, for each xi from the simple generator, the low-order bits of xi are used to select a random integer, j, from 1 to 128. The j-th entry in the table is then delivered as the random number, and xi, after being scaled into the unit interval, is inserted into the j-th position in the table.

The values returned by imsls_f_random_uniform are positive and less than 1.0. However, some values returned may be smaller than the smallest relative spacing; hence, it may be the case that some value, for example r [i], is such that 1.0 − r [i] = 1.0.

Deviates from the distribution with uniform density over the interval (a, b) can be obtained by scaling the output from imsls_f_random_uniform. The following statements (in single precision) would yield random deviates from a uniform
(a, b) distribution.

float *r;
r = imsls_f_random_uniform (n_random, 0);
for (i=0; i<n_random; i++) r[i] = r[i]*(b-a) + a;

Example

In this example, imsls_f_random_uniform generates five pseudorandom uniform numbers. Since function imsls_random_option is not called, the generator used is a simple multiplicative congruential one with a multiplier of 16807.

#include <imsls.h>
#include <stdio.h>

#define N_RANDOM  5

void main()
{
    float     *r;

    imsls_random_seed_set(123457);

    r = imsls_f_random_uniform(N_RANDOM, 0);

    printf("Uniform random deviates: %8.4f%8.4f%8.4f%8.4f%8.4f\n",
            r[0], r[1], r[2], r[3], r[4]);
}

Output

Uniform random deviates:   0.9662  0.2607  0.7663  0.5693  0.8448

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