g05 Chapter Contents
g05 Chapter Introduction (PDF version)
NAG C Library Manual

NAG Library Chapter Introduction

g05 – Random Number Generators

+ Contents

1  Scope of the Chapter

This chapter is concerned with the generation of sequences of independent pseudorandom and quasi-random numbers from various distributions, and the generation of pseudorandom time series from specified time series models.

2  Background to the Problems

2.1  Pseudorandom Numbers

A sequence of pseudorandom numbers is a sequence of numbers generated in some systematic way such that they are independent and statistically indistinguishable from a truly random sequence. A pseudorandom number generator (PRNG) is a mathematical algorithm that, given an initial state, produces a sequence of pseudorandom numbers. A PRNG has several advantages over a true random number generator in that the generated sequence is repeatable, has known mathematical properties and can be implemented without needing any specialist hardware. Many books on statistics and computer science have good introductions to PRNGs, for example Knuth (1981) or Banks (1998).
PRNGs can be split into base generators, and distributional generators. Within the context of this document a base generator is defined as a PRNG that produces a sequence (or stream) of variates (or values) uniformly distributed over the interval 0,1. Depending on the algorithm being considered, this interval may be open, closed or half-closed. A distribution generator is a function that takes variates generated from a base generator and transforms them into variates from a specified distribution, for example a uniform, Gaussian (Normal) or gamma distribution.
The period (or cycle length) of a base generator is defined as the maximum number of values that can be generated before the sequence starts to repeat. The initial state of the base generator is often called the seed.
There are six base generators currently available in the NAG C Library, these are; a basic linear congruential generator (LCG) (referred to as the NAG basic generator) (see Knuth (1981)), two sets of Wichmann–Hill generators (see Maclaren (1989) and Wichmann and Hill (2006)), the Mersenne Twister (see Matsumoto and Nishimura (1998)), the ACORN generator (see Wikramaratna (1989)) and L'Ecuyer generator (see L'Ecuyer and Simard (2002)).

2.1.1  NAG Basic Generator

The NAG basic generator is a linear congruential generator (LCG) and, like all linear congruential generators, has the form:
xi = a1 xi-1  mod  m1 , ui = xi m1 ,
where the ui, for i=1,2,, form the required sequence.
The NAG basic generator uses a1=1313 and m1=259, which gives a period of approximately 257.
This generator has been part of the NAG Library since Mark 6 and as such has been widely used. It suffers from no known problems, other than those due to the lattice structure inherent in all linear congruential generators, and, even though the period is relatively short compared to many of the newer generators, it is sufficiently large for many practical problems.
The performance of the NAG basic generator has been analysed by the Spectral Test, see Section 3.3.4 of Knuth (1981), yielding the following results in the notation of Knuth (1981).
n νn Upper bound for νn
2 3.44×108 4.08×108
3 4.29×105 5.88×105
4 1.72×104 2.32×104
5 1.92×103 3.33×103
6 593 939
7 198 380
8 108 197
9 67 120
The right-hand column gives an upper bound for the values of νn attainable by any multiplicative congruential generator working modulo 259.
An informal interpretation of the quantities νn is that consecutive n-tuples are statistically uncorrelated to an accuracy of 1/νn. This is a theoretical result; in practice the degree of randomness is usually much greater than the above figures might support. More details are given in Knuth (1981), and in the references cited therein.
Note that the achievable accuracy drops rapidly as the number of dimensions increases. This is a property of all multiplicative congruential generators and is the reason why very long periods are needed even for samples of only a few random numbers.

2.1.2  Wichmann–Hill I Generator

This series of Wichmann–Hill base generators (see Maclaren (1989)) use a combination of four linear congruential generators and has the form:
wi=a1wi-1  mod  m1 xi=a2xi-1  mod  m2 yi=a3yi-1  mod  m3 zi=a4zi-1  mod  m4 ui = wi m1 + xi m2 + yi m3 + zi m4  mod  1 , (1)
where the ui, for i=1,2,, form the required sequence. The NAG C Library implementation includes 273 sets of parameters, aj,mj, for j=1,2,3,4, to choose from.
The constants ai are in the range 112 to 127 and the constants mj are prime numbers in the range 16718909 to 16776971, which are close to 224=16777216. These constants have been chosen so that each of the resulting 273 generators are essentially independent, all calculations can be carried out in 32-bit integer arithmetic and the generators give good results with the spectral test, see Knuth (1981) and Maclaren (1989). The period of each of these generators would be at least 292 if it were not for common factors between m1-1, m2-1, m3-1 and m4-1. However, each generator should still have a period of at least 280. Further discussion of the properties of these generators is given in Maclaren (1989).

2.1.3  Wichmann–Hill II Generator

This Wichmann–Hill base generator (see Wichmann and Hill (2006)) is of the same form as that described in Section 2.1.2, i.e., a combination of four linear congruential generators. In this case a1=11600, m1=2147483579, a2=47003, m2=2147483543, a3=23000, m3=2147483423, a4=33000, m4=2147483123.
Unlike in the original Wichmann–Hill generator, these values are too large to carry out the calculations detailed in (1) using 32-bit integer arithmetic, however, if
wi = 11600 wi-1  mod  2147483579
then setting
Wi = 11600 wi-1  mod  185127 - 10379 wi-1 / 185127
gives
wi = Wi ​ if ​ Wi0 2147483579+Wi ​ otherwise
and Wi can be calculated in 32-bit integer arithmetic. Similar expressions exist for xi, yi and zi. The period of this generator is approximately 2121.
Further details of implementing this algorithm and its properties are given in Wichmann and Hill (2006). This paper also gives some useful guidelines on testing PRNGs.

2.1.4  Mersenne Twister Generator

The Mersenne Twister (see Matsumoto and Nishimura (1998)) is a twisted generalized feedback shift register generator. The algorithm underlying the Mersenne Twister is as follows:
(i) Set some arbitrary initial values x1,x2,,xr, each consisting of w bits.
(ii) Letting
A= 0 Iw-1 aw aw-1a1 ,
where Iw-1 is the w-1×w-1 identity matrix and each of the ai,i=1 to w take a value of either 0 or 1 (i.e., they can be represented as bits). Define
x i+r = x i+s x i ω : l+1 | x i+1 l:1 A ,
where x i ω : l+1 | x i+1 l:1  indicates the concatenation of the most significant (upper) w-l bits of xi and the least significant (lower) l bits of xi+1.
(iii) Perform the following operations sequentially:
z = xi+r xi+r t1 z = z z t2 ​ AND ​ m1 z = z z t3 ​ AND ​ m2 z = z z t4 u i+r = z/ 2w - 1 ,
where t1, t2, t3 and t4 are integers and m1 and m2 are bit-masks and ‘t’ and ‘t’ represent a t bit shift right and left respectively,  is bit-wise exclusively or (xor) operation and ‘AND’ is a bit-wise and operation.
The ui+r, for i=1,2,, form the required sequence. The supplied implementation of the Mersenne Twister uses the following values for the algorithmic constants:
w = 32 a = 0x9908b0 df l = 31 r = 624 s = 397 t1 = 11 t2 = 7 t3 = 15 t4 = 18 m1 = 0x9d2c5680 m2 = 0xefc60000
where the notation 0xDD  indicates the bit pattern of the integer whose hexadecimal representation is DD .
This algorithm has a period length of approximately 219,937-1 and has been shown to be uniformly distributed in 623 dimensions (see Matsumoto and Nishimura (1998)).

2.1.5  ACORN Generator

The ACORN generator is a special case of a multiple recursive generator (see Wikramaratna (1989) and Wikramaratna (2007)). The algorithm underlying ACORN is as follows:
(i) Choose an integer value k1.
(ii) Choose an integer value M, and an integer seed Y00, such that 0<Y00<M and Y00 and M are relatively prime.
(iii) Choose an arbitrary set of k initial integer values, Y01,Y02,,Y0k, such that 0 Y0m<M, for all m=1,2,,k.
(iv) Perform the following sequentially:
Y i m = Y i m-1 + Y i-1 m  mod  M
for m=1,2,,k.
(v) Set ui=Yik/M.
The ui, for i=1,2,, then form a pseudorandom sequence, with ui 0,1, for all i.
Although you can choose any value for k, M, Y00 and the Y0m, within the constraints mentioned in (i) to (iii) above, it is recommended that k10, M is chosen to be a large power of two with M260 and Y00 is chosen to be odd.
The period of the ACORN generator, with the modulus M equal to a power of two, and an odd value for Y00 has been shown to be an integer multiple of M (see Wikramaratna (1992)). Therefore, increasing M will give a series with a longer period.

2.1.6  L'Ecuyer MRG32k3a Combined Recursive Generator

The base generator L'Ecuyer MRG32k3a (see L'Ecuyer and Simard (2002)) combines two multiple recursive generators:
xi = a11 xi-1 + a12 xi-2 + a13 xi-3  mod m1 yi = a21 yi-1 + a22 yi-2 + a23 yi-3  mod m2 zi = xi - yi  mod m1 ui = zi + 1 / d
where a11 = 0 , a12 = 1403580 , a13 = -810728 , m1 = 232-209 , a21 = 527612 , a22 = 0 , a23 = -1370589 , m2 = 232-22853 , and ui , i = 1 , 2 ,  form the required sequence. If d=m1 then ui0,1 else if d=m1+1 then ui0,1. Combining the two multiple recursive generators (MRG) results in sequences with better statistical properties in high dimensions and longer periods compared with those generated from a single MRG. The combined generator described above has a period length of approximately 2191.

2.2  Quasi-random Numbers

Low discrepancy (quasi-random) sequences are used in numerical integration, simulation and optimization. Like pseudorandom numbers they are uniformly distributed but they are not statistically independent, rather they are designed to give more even distribution in multidimensional space (uniformity). Therefore they are often more efficient than pseudorandom numbers in multidimensional Monte–Carlo methods.
The quasi-random number generators implemented in this chapter generate a set of points x1,x2,,xN with high uniformity in the S-dimensional unit cube IS=0,1S. One measure of the uniformity is the discrepancy which is defined as follows:
Three types of low-discrepancy sequences are supplied in this library, these are due to Sobol, Faure and Niederreiter. Two sets of Sobol sequences are supplied, the first is based on work of Joe and Kuo (2008) and the second on the work of Bratley and Fox (1988). More information on quasi-random number generation and the Sobol, Faure and Niederreiter sequences in particular can be found in Bratley and Fox (1988) and Fox (1986).

2.3  Scrambled Quasi-random Numbers

Scrambled quasi-random sequences are an extension of standard quasi-random sequences that attempt to eliminate the bias inherent in a quasi-random sequence whilst retaining the low-discrepancy properties. The use of a scrambled sequence allows error estimation of Monte–Carlo results by performing a number of iterates and computing the variance of the results.
This implementation of scrambled quasi-random sequences is based on TOMS algorithm 823 and details can be found in the accompanying paper, Hong and Hickernell (2003). Three methods of scrambling are supplied; the first a restricted form of Owen's scrambling (Owen (1995)), the second based on the method of Faure and Tezuka (2000) and the last method combines the first two.
Scrambled versions of both Sobol sequences and the Niederreiter sequence can be obtained.
The efficiency of a simulation exercise may often be increased by the use of variance reduction methods (see Morgan (1984)). It is also worth considering whether a simulation is the best approach to solving the problem. For example, low-dimensional integrals are usually more efficiently calculated by functions in Chapter d01 rather than by Monte–Carlo integration.

2.4  Non-uniform Random Numbers

Random numbers from other distributions may be obtained from the uniform random numbers by the use of transformations and rejection techniques, and for discrete distributions, by table based methods.
(a) Transformation Methods
For a continuous random variable, if the cumulative distribution function (CDF) is Fx then for a uniform 0,1 random variate u, y=F-1u will have CDF Fx. This method is only efficient in a few simple cases such as the exponential distribution with mean μ, in which case F-1u=-μlogu. Other transformations are based on the joint distribution of several random variables. In the bivariate case, if v and w are random variates there may be a function g such that y=gv,w has the required distribution; for example, the Student's t-distribution with n degrees of freedom in which v has a Normal distribution, w has a gamma distribution and gv,w=vn/w.
(b) Rejection Methods
Rejection techniques are based on the ability to easily generate random numbers from a distribution (called the envelope) similar to the distribution required. The value from the envelope distribution is then accepted as a random number from the required distribution with a certain probability; otherwise, it is rejected and a new number is generated from the envelope distribution.
(c) Table Search Methods
For discrete distributions, if the cumulative probabilities, Pi=Probxi, are stored in a table then, given u from a uniform 0,1 distribution, the table is searched for i such that Pi-1<uPi. The returned value i will have the required distribution. The table searching can be made faster by means of an index, see Ripley (1987). The effort required to set up the table and its index may be considerable, but the methods are very efficient when many values are needed from the same distribution.

2.5  Copulas

A copula is a function that links the univariate marginal distributions with their multivariate distribution. Sklar's theorem (see Sklar (1973)) states that if f is an m-dimensional distribution function with continuous margins f1 , f2 ,, fm , then f has a unique copula representation, c, such that
f x1 , x2 ,, xm = c f1 x1 , f2 x2 ,, fm xm
The copula, c, is a multivariate uniform distribution whose dependence structure is defined by the dependence structure of the multivariate distribution f, with
c u1 , u2 ,, um = f f1-1 u1 , f2-1 u2 , , fm-1 um
where ui 0,1 . This relationship can be used to simulate variates from distributions defined by the dependence structure of one distribution and each of the marginal distributions given by another. For additional information see Nelsen (1998) or Boye (Unpublished manuscript) and the references therein.

2.6  Other Random Structures

In addition to random numbers from various distributions, random compound structures can be generated. These include random time series, random matrices and random samples.

2.7  Multiple Streams of Pseudorandom Numbers

It is often advantageous to be able to generate variates from multiple, independent, streams (or sequences) of random variates. For example when running a simulation in parallel on several processors. There are four ways of generating multiple streams using the functions available in this chapter:
(i) using different initial values (seeds);
(ii) using different generators;
(iii) skip ahead (also called block-splitting);
(iv) leap-frogging.

2.7.1  Multiple Streams via Different Initial Values (Seeds)

A different sequence of variates can be generated from the same base generator by initializing the generator using a different set of seeds. The statistical properties of the base generators are only guaranteed within, not between sequences. For example, two sequences generated from two different starting points may overlap if these initial values are not far enough apart. The potential for overlapping sequences is reduced if the period of the generator being used is large. In general, of the four methods for creating multiple streams described here, this is the least satisfactory.
The one exception to this is the Wichmann–Hill II generator. The Wichmann and Hill (2006) paper describes a method of generating blocks of variates, with lengths up to 290, by fixing the first three seed values of the generator (w0, x0 and y0), and setting z0 to a different value for each stream required. This is similar to the skip-ahead method described in Section 2.7.3, in that the full sequence of the Wichmann–Hill II generator is split into a number of different blocks, in this case with a fixed length of 290. But without the computationally intensive initialization usually required for the skip-ahead method.

2.7.2  Multiple Streams via Different Generators

Independent sequences of variates can be generated using a different base generator for each sequence. For example, sequence 1 can be generated using the NAG basic generator, sequence 2 using Mersenne Twister, sequence 3 the ACORN generator and sequence 4 using L'Ecuyer generator. The Wichmann–Hill I generator implemented in this chapter is, in fact, a series of 273 independent generators. The particular sub-generator to use is selected using the subid variable. Therefore, in total, 278 independent streams can be generated with each using a different generator (273 Wichmann–Hill I generators, and 5 additional base generators).

2.7.3  Multiple Streams via Skip-ahead

Independent sequences of variates can be generated from a single base generator through the use of block-splitting, or skipping-ahead. This method consists of splitting the sequence into k non-overlapping blocks, each of length n, where n is no smaller than the maximum number of variates required from any of the sequences. For example,
x1 , x2 , , xn block 1 , xn+1 , xn+2 , , x2n block 2 , x2n+1 , x2n+2 , , x3n block 3 , etc.
where x1,x2, is the sequence produced by the generator of interest. Each of the k blocks provide an independent sequence.
The skip-ahead algorithm therefore requires the sequence to be advanced a large number of places, as to generate values from say, block b, you must skip over the b-1n values in the first b-1 blocks. Due to their form this can be done efficiently for linear congruential generators and multiple congruential generators. A skip-ahead algorithm is also provided for the Mersenne Twister generator.
Although skip-ahead requires some additional computation at the initialization stage (to ‘fast forward’ the sequence) no additional computation is required at the generation stage.
This method of producing multiple streams can also be used for the Sobol and Niederreiter quasi-random number generator via the argument iskip in nag_quasi_init (g05ylc).

2.7.4  Multiple Streams via Leap-frog

Independent sequences of variates can also be generated from a single base generator through the use of leap-frogging. This method involves splitting the sequence from a single generator into k disjoint subsequences. For example:
Subsequence 1: x1 , xk+1 , x 2k+1 , Subsequence 2: x2 , xk+2 , x 2k+2 , Subsequence ​k: xk , x2k , x3k , ,
where x1,x2, is the sequence produced by the generator of interest. Each of the k subsequences then provides an independent stream of variates.
The leap-frog algorithm therefore requires the generation of every kth variate from the base generator. Due to their form this can be done efficiently for linear congruential generators and multiple congruential generators. A leap-frog algorithm is provided for the NAG Basic generator, both the Wichmann–Hill I and Wichmann–Hill II generators and L'Ecuyer generator.
It is known that, dependent on the number of streams required, leap-frogging can lead to sequences with poor statistical properties, especially when applied to linear congruential generators. In addition, leap-frogging can increase the time required to generate each variate. Therefore leap-frogging should be avoided unless absolutely necessary.

2.7.5  Skip-ahead and Leap-frog for a Linear Congruential Generator (LCG): An Example

As an illustrative example, a brief description of the algebra behind the implementation of the leap-frog and skip-ahead algorithms for a linear congruential generator is given. A linear congruential generator has the form xi+1=a1 xi  mod  m1. The recursive nature of a linear congruential generator means that
xi+v = a1 x i+v-1  mod  m1 = a1 a1 x i+v-2  mod  m1  mod  m1 = a 1 2 x i+v-2  mod  m1 = a1v xi  mod  m1 .
The sequence can therefore be quickly advanced v places by multiplying the current state (xi) by a1v  mod  m1, hence skipping the sequence ahead. Leap-frogging can be implemented by using a1k, where k is the number of streams required, in place of a1 in the standard linear congruential generator recursive formula, in order to advance k places, rather than one, at each iteration.
In a linear congruential generator the multiplier a1 is constructed so that the generator has good statistical properties in, for example, the spectral test. When using leap-frogging to construct multiple streams this multiplier is replaced with a1k, and there is no guarantee that this new multiplier will have suitable properties especially as the value of k depends on the number of streams required and so is likely to change depending on the application. This problem can be emphasized by the lattice structure of linear congruential generators. Similiarly, the value of a1 is often chosen such that the computation a1 xi  mod  m1 can be performed efficiently. When a1 is replaced by a1k, this is often no longer the case.
Note that, due to rounding, when using a distributional generator, a sequence generated using leap-frogging and a sequence constructed by taking every k value from a set of variates generated without leap-frogging may differ slightly. These differences should only affect the least significant digit.

2.7.6  Skip-ahead and Leap-frog for the Mersenne Twister: An Example

Skipping ahead with the Mersenne Twister generator is based on the definition of a k×k (where k=19937) transition matrix, A, over the finite field 𝔽2 (with elements 0 and 1). Multiplying A by the current state xn, represented as a vector of bits, produces the next state vector xn+1:
x n + 1 = A x n .
Thus, skipping ahead v places in a sequence is equivalent to multiplying by Av:
x n + v = A v x n .
Since calculating Av by a standard square and multiply algorithm is Ok3 logv and requires over 47MB of memory (see Haramoto et al. (2008)), an indirect calculation is performed which relies on a property of the characteristic polynomial pz of A, namely that pA=0. We then define
gz = z v  mod  pz = a k - 1 z k - 1 + + a 1 z + a 0 ,
and observe that
gz = z v + qz p z
for a polynomial qz. Since pA=0, we have that g A = A v  and
A v x n = a k - 1 A k - 1 + + a 1 A + a 0 I x n .
This polynomial evaluation can be performed using Horner's method:
A v x n = A A A A a k - 1 x n + a k - 2 x n + a k - 3 x n + + a 1 x n + a 0 x n ,
which reduces the problem to advancing the generator k-1 places from state xn and adding (where addition is as defined over 𝔽2) the intermediate states for which ai is nonzero.
There are therefore two stages to skipping the Mersenne Twister ahead v places:
(i) Calculate the coefficients of the polynomial g z = z v  mod  p z ;
(ii) advance the sequence k-1 places from the starting state and add the intermediate states that correspond to nonzero coefficients in the polynomial calculated in the first step.
The resulting state is that for position v in the sequence.
The cost of calculating the polynomial is O k 2 logv  and the cost of applying it to state is constant. Skip ahead functionality is typically used in order to generate n independent pseudorandom number streams (e.g., for separate threads of computation). There are two options for generating the n states:
(i) On the master thread calculate the polynomial for a skip ahead distance of v and apply this polynomial to state n times, after each iteration j saving the current state for later usage by thread j.
(ii) Have each thread j independently and in parallel with other threads calculate the polynomial for a distance of j+1v and apply to the original state.
Since lim v logv = log n v , then for large v the cost of generating the polynomial for a skip ahead distance of nv (i.e., the calculation performed by thread n-1 in option (ii) above) is approximately the same as generating that for a distance of v (i.e., the calculation performed by thread 0). However, only one application to state need be made per thread, and if n is sufficiently large the cost of applying the polynomial to state becomes the dominant cost in option (i), in which case it is desirable to use option (ii). Tests have shown that as a guideline it becomes worthwhile to switch from option (i) to option (ii) for approximately n>30.
Leap frog calculations with the Mersenne Twister are performed by computing the sequence fully up to the required size and discarding the redundant numbers for a given stream.

3  Recommendations on Choice and Use of Available Functions

3.1  Pseudorandom Numbers

Prior to generating any pseudorandom variates the base generator being used must be initialized. Once initialized, a distributional generator can be called to obtain the variates required. No interfaces have been supplied for direct access to the base generators. If a sequence of random variates from a uniform distribution on the open interval 0,1, is required, then the uniform distribution function (nag_rand_basic (g05sac)) should be called.

3.1.1  Initialization

Prior to generating any variates the base generator must be initialized. Two utility functions are provided for this, nag_rand_init_repeatable (g05kfc) and nag_rand_init_nonrepeatable (g05kgc), both of which allow any of the base generators to be chosen.
nag_rand_init_repeatable (g05kfc) selects and initializes a base generator to a repeatable (when executed serially) state: two calls of nag_rand_init_repeatable (g05kfc) with the same argument-values will result in the same subsequent sequences of random numbers (when both generated serially).
nag_rand_init_nonrepeatable (g05kgc) selects and initializes a base generator to a non-repeatable state in such a way that different calls of nag_rand_init_nonrepeatable (g05kgc), either in the same run or different runs of the program, will almost certainly result in different subsequent sequences of random numbers.
No utilities for saving, retrieving or copying the current state of a generator have been provided. All of the information on the current state of a generator (or stream, if multiple streams are being used) is stored in the integer array state and as such this array can be treated as any other integer array, allowing for easy copying, restoring, etc.

3.1.2  Repeated initialization

As mentioned in Section 2.7.1, it is important to note that the statistical properties of pseudorandom numbers are only guaranteed within sequences and not between sequences produced by the same generator. Repeated initialization will thus render the numbers obtained less rather than more independent. In a simple case there should be only one call to nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc) and this call should be before any call to an actual generation function.

3.1.3  Choice of Base Generator

If a single sequence is required then it is recommended that the Mersenne Twister is used as the base generator (genid=3). This generator is fast, has an extremely long period and has been shown to perform well on various test suites, see Matsumoto and Nishimura (1998), L'Ecuyer and Simard (2002) and Wichmann and Hill (2006) for example.
When choosing a base generator, the period of the chosen generator should be borne in mind. A good rule of thumb is never to use more numbers than the square root of the period in any one experiment as the statistical properties are impaired. For closely related reasons, breaking numbers down into their bit patterns and using individual bits may also cause trouble.

3.1.4  Choice of Method for Generating Multiple Streams

If the Wichmann–Hill II base generator is being used, and a period of 290 is sufficient, then the method described in Section 2.7.1 can be used. If a different generator is used, or a longer period length is required then generating multiple streams by altering the initial values should be avoided.
Using a different generator works well if less than 277 streams are required.
Of the remaining two methods, both skip-ahead and leap-frogging use the sequence from a single generator, both guarantee that the different sequences will not overlap and both can be scaled to an arbitrary number of streams. Leap-frogging requires no a-priori knowledge about the number of variates being generated, whereas skip-ahead requires you to know (approximately) the maximum number of variates required from each stream. Skip-ahead requires no a-priori information on the number of streams required. In contrast leap-frogging requires you to know the maximum number of streams required, prior to generating the first value. Of these two, if possible, skip-ahead should be used in preference to leap-frogging. Both methods required additional computation compared with generating a single sequence, but for skip-ahead this computation occurs only at initialization. For leap-frogging additional computation is required both at initialization and during the generation of the variates. In addition, as mentioned in Section 2.7.4, using leap-frogging can, in some instances, change the statistical properties of the sequences being generated.

3.1.5  Copulas

After calling any of the copula functions the g01t functions in Chapter g01 can be used to convert the uniform marginal distributors into a different form as required.

3.2  Quasi-random Numbers

Prior to generating any quasi-random variates the generator being used must be initialized via nag_quasi_init (g05ylc) or nag_quasi_init_scrambled (g05ync). Of these, nag_quasi_init (g05ylc) can be used to initialize a standard Sobol, Faure or Niederreiter sequence and nag_quasi_init_scrambled (g05ync) can be used to initialize a scrambled Sobol or Niederreiter sequence.
Due to the random nature of the scrambling, prior to calling the initialization function nag_quasi_init_scrambled (g05ync) one of the pseudorandom initialization functions, nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc), must be called.
Once a quasi-random generator has been initialized, using either nag_quasi_init (g05ylc) or nag_quasi_init_scrambled (g05ync), one of three generation functions can be called to generate uniformly distributed sequences (nag_quasi_rand_uniform (g05ymc)), Normally distributed sequences (nag_quasi_rand_normal (g05yjc)) or sequences with a log-normal distribution (nag_quasi_rand_lognormal (g05ykc)). For example, for a repeatable sequence of scrambled quasi-random variates from the Normal distribution, nag_rand_init_repeatable (g05kfc) must be called first (to initialize a pseudorandom generator), followed by nag_quasi_init_scrambled (g05ync) (to initialize a scrambled quasi-random generator) and then nag_quasi_rand_normal (g05yjc) can be called to generate the sequence from the required distribution.
Sequences from other distributions can be obtained by calling the ‘deviate’ functions supplied in Chapter g01 on the results from nag_quasi_rand_uniform (g05ymc). However, care should be taken when doing this as some of these ‘deviate’ functions are only accurate up to a limited number of significant figures which may effect the statistical properties of the resulting sequence of variates.

3.3  Programming Advice

Take care when programming calls to those functions in this chapter which are functions. The reason is that different calls with the same arguments are intended to give different results.
For example, if you wish to assign to z the difference between two successive random numbers generated by nag_rngs_basic (g05kac), beware of writing
z = g05kac(igen,iseed) - g05kac(igen,iseed)
It is quite legitimate for a C compiler to compile zero, one or two calls to nag_rngs_basic (g05kac); if two calls, they may be in either order (if zero or one calls are compiled, z would be set to zero). A safe method to program this would be
x = g05kac(igen,iseed);
y = g05kac(igen,iseed);
z = x-y

4  Functionality Index

Generating samples, matrices and tables, 
    random correlation matrix nag_rand_corr_matrix (g05pyc)
    random orthogonal matrix nag_rand_orthog_matrix (g05pxc)
    random permutation of an integer vector nag_rand_permute (g05ncc)
    random sample from an integer vector 
        unequal weights, without replacement nag_rand_sample_unequal (g05nec)
        unweighted, without replacement nag_rand_sample (g05ndc)
    random table nag_rand_2_way_table (g05pzc)
Generation of time series, 
    asymmetric GARCH Type II nag_rand_agarchII (g05pec)
    asymmetric GJR GARCH nag_rand_garchGJR (g05pfc)
    EGARCH nag_rand_egarch (g05pgc)
    exponential smoothing nag_rand_exp_smooth (g05pmc)
    type I AGARCH nag_rand_agarchI (g05pdc)
    univariate ARMA nag_rand_arma (g05phc)
    vector ARMA nag_rand_varma (g05pjc)
Pseudorandom numbers, 
    array of variates from multivariate distributions, 
        Dirichlet distribution nag_rand_dirichlet (g05sec)
        multinomial distribution nag_rand_gen_multinomial (g05tgc)
        Normal distribution nag_rand_matrix_multi_students_t (g05ryc)
        Student's t distribution nag_rand_matrix_multi_normal (g05rzc)
    copulas 
        Clayton/Cook–Johnson copula (bivariate) nag_rand_bivariate_copula_clayton (g05rec)
        Clayton/Cook–Johnson copula (multivariate) nag_rand_copula_clayton (g05rhc)
        Frank copula (bivariate) nag_rand_bivariate_copula_frank (g05rfc)
        Frank copula (multivariate) nag_rand_copula_frank (g05rjc)
        Gaussian copula nag_rand_copula_normal (g05rdc)
        Gumbel–Hougaard copula nag_rand_copula_gumbel (g05rkc)
        Plackett copula nag_rand_bivariate_copula_plackett (g05rgc)
        Student's t copula nag_rand_copula_students_t (g05rcc)
    initialize generator, 
        multiple streams, 
            leap-frog nag_rand_leap_frog (g05khc)
            skip-ahead nag_rand_skip_ahead (g05kjc)
            skip-ahead (power of 2) nag_rand_skip_ahead_power2 (g05kkc)
        nonrepeatable sequence nag_rand_init_nonrepeatable (g05kgc)
        repeatable sequence nag_rand_init_repeatable (g05kfc)
    vector of variates from discrete univariate distributions, 
        binomial distribution nag_rand_binomial (g05tac)
        geometric distribution nag_rand_geom (g05tcc)
        hypergeometric distribution nag_rand_hypergeometric (g05tec)
        logarithmic distribution nag_rand_logarithmic (g05tfc)
        logical value Nag_TRUE or Nag_FALSE nag_rand_logical (g05tbc)
        negative binomial distribution nag_rand_neg_bin (g05thc)
        Poisson distribution nag_rand_poisson (g05tjc)
        uniform distribution nag_rand_discrete_uniform (g05tlc)
        user-supplied distribution nag_rand_gen_discrete (g05tdc)
        variate array from discrete distributions with array of parameters, 
            Poisson distribution with varying mean nag_rand_compd_poisson (g05tkc)
    vectors of variates from continuous univariate distributions, 
        beta distribution nag_rand_beta (g05sbc)
        Cauchy distribution nag_rand_cauchy (g05scc)
        exponential mix distribution nag_rand_exp_mix (g05sgc)
        F-distribution nag_rand_f (g05shc)
        gamma distribution nag_rand_gamma (g05sjc)
        logistic distribution nag_rand_logistic (g05slc)
        log-normal distribution nag_rand_lognormal (g05smc)
        negative exponential distribution nag_rand_exp (g05sfc)
        Normal distribution nag_rand_normal (g05skc)
        real number from the continuous uniform distribution nag_rand_basic (g05sac)
        Student's t-distribution nag_rand_students_t (g05snc)
        triangular distribution nag_rand_triangular (g05spc)
        uniform distribution nag_rand_uniform (g05sqc)
        von Mises distribution nag_rand_von_mises (g05src)
        Weibull distribution nag_rand_weibull (g05ssc)
        χ2 square distribution nag_rand_chi_sq (g05sdc)
Quasi-random numbers, 
    array of variates from univariate distributions, 
        log-normal distribution nag_quasi_rand_lognormal (g05ykc)
        Normal distribution nag_quasi_rand_normal (g05yjc)
        uniform distribution nag_quasi_rand_uniform (g05ymc)
    initialize generator, 
        scrambled Sobol or Niederreiter nag_quasi_init_scrambled (g05ync)
        Sobol, Niederreiter or Faure nag_quasi_init (g05ylc)

5  Functions Withdrawn or Scheduled for Withdrawal

Withdrawn
Function
Mark of
Withdrawal

Replacement Function(s)
nag_random_continuous_uniform (g05cac)24nag_rand_basic (g05sac)
nag_random_init_repeatable (g05cbc)24nag_rand_init_repeatable (g05kfc)
nag_random_init_nonrepeatable (g05ccc)24nag_rand_init_nonrepeatable (g05kgc)
nag_save_random_state (g05cfc)24No longer required.
nag_restore_random_state (g05cgc)24No longer required.
nag_random_continuous_uniform_ab (g05dac)24nag_rand_uniform (g05sqc)
nag_random_exp (g05dbc)24nag_rand_exp (g05sfc)
nag_random_normal (g05ddc)24nag_rand_normal (g05skc)
nag_random_discrete_uniform (g05dyc)24nag_rand_discrete_uniform (g05tlc)
nag_ref_vec_multi_normal (g05eac)24nag_rand_matrix_multi_normal (g05rzc)
nag_ref_vec_poisson (g05ecc)24nag_rand_poisson (g05tjc)
nag_ref_vec_binomial (g05edc)24nag_rand_binomial (g05tac)
nag_ran_permut_vec (g05ehc)24nag_rand_permute (g05ncc)
nag_ran_sample_vec (g05ejc)24nag_rand_sample (g05ndc)
nag_ref_vec_discrete_pdf_cdf (g05exc)24nag_rand_gen_discrete (g05tdc)
nag_return_discrete (g05eyc)24nag_rand_gen_discrete (g05tdc)
nag_return_multi_normal (g05ezc)24nag_rand_matrix_multi_normal (g05rzc)
nag_random_beta (g05fec)24nag_rand_beta (g05sbc)
nag_random_gamma (g05ffc)24nag_rand_gamma (g05sjc)
nag_arma_time_series (g05hac)24nag_rand_arma (g05phc)
nag_generate_agarchI (g05hkc)24nag_rand_agarchI (g05pdc)
nag_generate_agarchII (g05hlc)24nag_rand_agarchII (g05pec)
nag_generate_garchGJR (g05hmc)24nag_rand_garchGJR (g05pfc)
nag_rngs_basic (g05kac)24nag_rand_basic (g05sac)
nag_rngs_init_repeatable (g05kbc)24nag_rand_init_repeatable (g05kfc)
nag_rngs_init_nonrepeatable (g05kcc)24nag_rand_init_nonrepeatable (g05kgc)
nag_rngs_logical (g05kec)24nag_rand_logical (g05tbc)
nag_rngs_normal (g05lac)24nag_rand_normal (g05skc)
nag_rngs_students_t (g05lbc)24nag_rand_students_t (g05snc)
nag_rngs_chi_sq (g05lcc)24nag_rand_chi_sq (g05sdc)
nag_rngs_f (g05ldc)24nag_rand_f (g05shc)
nag_rngs_beta (g05lec)24nag_rand_beta (g05sbc)
nag_rngs_gamma (g05lfc)24nag_rand_gamma (g05sjc)
nag_rngs_uniform (g05lgc)24nag_rand_uniform (g05sqc)
nag_rngs_triangular (g05lhc)24nag_rand_triangular (g05spc)
nag_rngs_exp (g05ljc)24nag_rand_exp (g05sfc)
nag_rngs_lognormal (g05lkc)24nag_rand_lognormal (g05smc)
nag_rngs_cauchy (g05llc)24nag_rand_cauchy (g05scc)
nag_rngs_weibull (g05lmc)24nag_rand_weibull (g05ssc)
nag_rngs_logistic (g05lnc)24nag_rand_logistic (g05slc)
nag_rngs_von_mises (g05lpc)24nag_rand_von_mises (g05src)
nag_rngs_exp_mix (g05lqc)24nag_rand_exp_mix (g05sgc)
nag_rngs_matrix_multi_students_t (g05lxc)24nag_rand_matrix_multi_students_t (g05ryc)
nag_rgsn_matrix_multi_normal (g05lyc)24nag_rand_matrix_multi_normal (g05rzc)
nag_rngs_multi_normal (g05lzc)24nag_rand_matrix_multi_normal (g05rzc)
nag_rngs_discrete_uniform (g05mac)24nag_rand_discrete_uniform (g05tlc)
nag_rngs_geom (g05mbc)24nag_rand_geom (g05tcc)
nag_rngs_neg_bin (g05mcc)24nag_rand_neg_bin (g05thc)
nag_rngs_logarithmic (g05mdc)24nag_rand_logarithmic (g05tfc)
nag_rngs_compd_poisson (g05mec)24nag_rand_compd_poisson (g05tkc)
nag_rngs_binomial (g05mjc)24nag_rand_binomial (g05tac)
nag_rngs_poisson (g05mkc)24nag_rand_poisson (g05tjc)
nag_rngs_hypergeometric (g05mlc)24nag_rand_hypergeometric (g05tec)
nag_rngs_gen_multinomial (g05mrc)24nag_rand_gen_multinomial (g05tgc)
nag_rngs_gen_discrete (g05mzc)24nag_rand_gen_discrete (g05tdc)
nag_rngs_permute (g05nac)24nag_rand_permute (g05ncc)
nag_rngs_sample (g05nbc)24nag_rand_sample (g05ndc)
nag_rngs_arma_time_series (g05pac)24nag_rand_arma (g05phc)
nag_rngs_varma_time_series (g05pcc)24nag_rand_varma (g05pjc)
nag_rngs_orthog_matrix (g05qac)24nag_rand_orthog_matrix (g05pxc)
nag_rngs_corr_matrix (g05qbc)24nag_rand_corr_matrix (g05pyc)
nag_rngs_2_way_table (g05qdc)24nag_rand_2_way_table (g05pzc)
nag_rngs_copula_normal (g05rac)24nag_rand_copula_normal (g05rdc)
nag_rngs_copula_students_t (g05rbc)24nag_rand_copula_students_t (g05rcc)
nag_quasi_random_uniform (g05yac)24nag_quasi_init (g05ylc) and nag_quasi_rand_uniform (g05ymc)
nag_quasi_random_normal (g05ybc)24nag_quasi_rand_normal (g05yjc) and nag_quasi_init (g05ylc)

6  References

Banks J (1998) Handbook on Simulation Wiley
Boye E (Unpublished manuscript) Copulas for finance: a reading guide and some applications Financial Econometrics Research Centre, City University Business School, London
Bratley P and Fox B L (1988) Algorithm 659: implementing Sobol's quasirandom sequence generator ACM Trans. Math. Software 14(1) 88–100
Faure H and Tezuka S (2000) Another random scrambling of digital (t,s)-sequences Monte Carlo and Quasi-Monte Carlo Methods Springer-Verlag, Berlin, Germany (eds K T Fang, F J Hickernell and H Niederreiter)
Fox B L (1986) Algorithm 647: implementation and relative efficiency of quasirandom sequence generators ACM Trans. Math. Software 12(4) 362–376
Haramoto H, Matsumoto M, Nishimura T, Panneton F and L'Ecuyer P (2008) Efficient jump ahead for F2-linear random number generators INFORMS J. on Computing 20(3) 385–390
Hong H S and Hickernell F J (2003) Algorithm 823: implementing scrambled digital sequences ACM Trans. Math. Software 29:2 95–109
Joe S and Kuo F Y (2008) Constructing Sobol sequences with better two-dimensional projections SIAM J. Sci. Comput. 30 2635–2654
Knuth D E (1981) The Art of Computer Programming (Volume 2) (2nd Edition) Addison–Wesley
L'Ecuyer P and Simard R (2002) TestU01: a software library in ANSI C for empirical testing of random number generators Departement d'Informatique et de Recherche Operationnelle, Universite de Montreal http://www.iro.umontreal.ca/~lecuyer
Maclaren N M (1989) The generation of multiple independent sequences of pseudorandom numbers Appl. Statist. 38 351–359
Matsumoto M and Nishimura T (1998) Mersenne twister: a 623-dimensionally equidistributed uniform pseudorandom number generator ACM Transactions on Modelling and Computer Simulations
Morgan B J T (1984) Elements of Simulation Chapman and Hall
Nelsen R B (1998) An Introduction to Copulas. Lecture Notes in Statistics 139 Springer
Owen A B (1995) Randomly permuted (t,m,s)-nets and (t,s)-sequences Monte Carlo and Quasi-Monte Carlo Methods in Scientific Computing, Lecture Notes in Statistics 106 Springer-Verlag, New York, NY 299–317 (eds H Niederreiter and P J-S Shiue)
Ripley B D (1987) Stochastic Simulation Wiley
Sklar A (1973) Random variables: joint distribution functions and copulas Kybernetika 9 499–460
Wichmann B A and Hill I D (2006) Generating good pseudo-random numbers Computational Statistics and Data Analysis 51 1614–1622
Wikramaratna R S (1989) ACORN - a new method for generating sequences of uniformly distributed pseudo-random numbers Journal of Computational Physics 83 16–31
Wikramaratna R S (1992) Theoretical background for the ACORN random number generator Report AEA-APS-0244 AEA Technology, Winfrith, Dorest, UK
Wikramaratna R S (2007) The additive congruential random number generator a special case of a multiple recursive generator Journal of Computational and Applied Mathematics

g05 Chapter Contents
g05 Chapter Introduction (PDF version)
NAG C Library Manual

© The Numerical Algorithms Group Ltd, Oxford, UK. 2012