vRngUniform
Continuous Distribution Generators
vRngUniform
Continuous Distribution GeneratorsGenerates random numbers with uniform
distribution.
Syntax
status
=
vsRngUniform
(
method
,
stream
,
n
,
r
,
a
,
b
);
status
=
vdRngUniform
(
method
,
stream
,
n
,
r
,
a
,
b
);
Include Files
- mkl.h
Description
The are the left and
right bounds of the interval, respectively, and .
vRngUniform
function generates random
numbers uniformly distributed over the interval [
, where a
, b
)a
, b
a
, b
∈
R
; a
< b
The probability density function is given by:
The cumulative distribution function is as follows:
Product and Performance Information
|
|---|
Performance varies by use, configuration
and other factors. Learn more at www.Intel.com/PerformanceIndex. Notice revision #20201201 |
Input Parameters
Name | Type | Description |
|---|---|---|
method | const MKL_INT | Generation method; the
specific values are as follows:
Standard method. |
stream | VSLStreamStatePtr | Pointer to the stream state
structure |
n | const MKL_INT | Number of random values
to be generated. |
a | const float for vsRngUniform const double for vdRngUniform | Left bound a . |
b | const float for vsRngUniform const double for vdRngUniform | Right bound b . |
Output Parameters
Name | Type | Description |
|---|---|---|
r | float* for vsRngUniform double* for vdRngUniform | Vector of n random numbers uniformly
distributed over the interval [ a ,b ) |
Return Values
- VSL_ERROR_OK, VSL_STATUS_OK
- Indicates no error, execution is successful.
- VSL_ERROR_NULL_PTR
- streamis aNULLpointer.
- VSL_RNG_ERROR_BAD_STREAM
- streamis not a valid random stream.
- VSL_RNG_ERROR_BAD_UPDATE
- Callback function for an abstract BRNG returns an invalid number of updated entries in a buffer, that is,< 0or> nmax.
- VSL_RNG_ERROR_NO_NUMBERS
- Callback function for an abstract BRNG returns 0 as the number of updated entries in a buffer.
- VSL_RNG_ERROR_QRNG_PERIOD_ELAPSED
- Period of the generator has been exceeded.
- VSL_RNG_ERROR_NONDETERM_NRETRIES_EXCEEDED
- Number of retries to generate a random number by using non-deterministic random number generator exceeds threshold.
- VSL_RNG_ERROR_ARS5_NOT_SUPPORTED
- ARS-5 random number generator is not supported on the CPU running the application.