PDF version (NAG web site
, 64-bit version, 64-bit version)
NAG Toolbox: nag_rand_dist_beta (g05sb)
Purpose
nag_rand_dist_beta (g05sb) generates a vector of pseudorandom numbers taken from a beta distribution with parameters and .
Syntax
Description
The beta distribution has PDF (probability density function)
One of four algorithms is used to generate the variates depending on the values of
and
. Let
be the maximum and
be the minimum of
and
. Then the algorithms are as follows:
(i) |
if , Johnk's algorithm is used, see for example Dagpunar (1988). This generates the beta variate as , where and are uniformly distributed random variates; |
(ii) |
if , the algorithm BB given by Cheng (1978) is used. This involves the generation of an observation from a beta distribution of the second kind by the envelope rejection method using a log-logistic target distribution and then transforming it to a beta variate; |
(iii) |
if and , the switching algorithm given by Atkinson (1979) is used. The two target distributions used are and , along with the approximation to the switching argument of ; |
(iv) |
in all other cases, Cheng's BC algorithm (see Cheng (1978)) is used with modifications suggested by Dagpunar (1988). This algorithm is similar to BB, used when , but is tuned for small values of and . |
One of the initialization functions
nag_rand_init_repeat (g05kf) (for a repeatable sequence if computed sequentially) or
nag_rand_init_nonrepeat (g05kg) (for a non-repeatable sequence) must be called prior to the first call to
nag_rand_dist_beta (g05sb).
References
Atkinson A C (1979) A family of switching algorithms for the computer generation of beta random variates Biometrika 66 141–5
Cheng R C H (1978) Generating beta variates with nonintegral shape parameters Comm. ACM 21 317–322
Dagpunar J (1988) Principles of Random Variate Generation Oxford University Press
Hastings N A J and Peacock J B (1975) Statistical Distributions Butterworth
Parameters
Compulsory Input Parameters
- 1:
– int64int32nag_int scalar
-
, the number of pseudorandom numbers to be generated.
Constraint:
.
- 2:
– double scalar
-
, the parameter of the beta distribution.
Constraint:
.
- 3:
– double scalar
-
, the parameter of the beta distribution.
Constraint:
.
- 4:
– int64int32nag_int array
-
Note: the actual argument supplied
must be the array
state supplied to the initialization routines
nag_rand_init_repeat (g05kf) or
nag_rand_init_nonrepeat (g05kg).
Contains information on the selected base generator and its current state.
Optional Input Parameters
None.
Output Parameters
- 1:
– int64int32nag_int array
-
Contains updated information on the state of the generator.
- 2:
– double array
-
The pseudorandom numbers from the specified beta distribution.
- 3:
– int64int32nag_int scalar
unless the function detects an error (see
Error Indicators and Warnings).
Error Indicators and Warnings
Errors or warnings detected by the function:
-
-
Constraint: .
-
-
Constraint: .
-
-
Constraint: .
-
-
On entry,
state vector has been corrupted or not initialized.
-
An unexpected error has been triggered by this routine. Please
contact
NAG.
-
Your licence key may have expired or may not have been installed correctly.
-
Dynamic memory allocation failed.
Accuracy
Not applicable.
Further Comments
To generate an observation, , from the beta distribution of the second kind from an observation, , generated by nag_rand_dist_beta (g05sb) the transformation, , may be used.
Example
This example prints a set of five pseudorandom numbers from a beta distribution with parameters
and
, generated by a single call to
nag_rand_dist_beta (g05sb), after initialization by
nag_rand_init_repeat (g05kf).
Open in the MATLAB editor:
g05sb_example
function g05sb_example
fprintf('g05sb example results\n\n');
seed = [int64(1762543)];
genid = int64(1);
subid = int64(1);
[state, ifail] = g05kf( ...
genid, subid, seed);
n = int64(5);
a = 2;
b = 2;
[state, x, ifail] = g05sb( ...
n, a, b, state);
disp('Variates');
disp(x);
g05sb example results
Variates
0.5977
0.6818
0.1797
0.4174
0.4987
PDF version (NAG web site
, 64-bit version, 64-bit version)
© The Numerical Algorithms Group Ltd, Oxford, UK. 2009–2015