uniform (Discrete)#
Generates random numbers uniformly distributed over the interval [a, b)
.
Description#
The uniform
class object is used in
generate
functions to provide random numbers uniformly distributed over the interval [a, b)
,
where a, b
are the left and right bounds of the interval respectively, and \(a, b \in Z; a < b\).
The probability distribution is given by:
The cumulative distribution function is as follows:
API#
Syntax#
namespace oneapi::mkl::rng {
template<typename Method>
class uniform<std::(u)int32_t, Method> {
public:
using method_type = Method;
using result_type = std::(u)int32_t;
uniform(): uniform((std::(u)int32_t )(0),
std::is_same<Method,
uniform_method::standard>::value ? (1 << 23) :
std::numeric_limits<Type>::max()){}
explicit uniform(std::(u)int32_t a, std::(u)int32_t b);
explicit uniform(const param_type& pt);
std::(u)int32_t a() const;
std::(u)int32_t b() const;
param_type param() const;
void param(const param_type& pt);
};
}
Devices supported: CPU and GPU.
Include Files#
oneapi/mkl/rng.hpp
Template Parameters#
|
Generation method. The specific values are as follows:
See brief descriptions of the methods in Distributions Template Parameter Method. |
Note
The oneapi::mkl::rng::uniform_method::standard
uses the s
BRNG type on GPU devices. This might
cause the produced numbers to have incorrect statistics (due to rounding error) when
\((abs(b – a) > 2^{23} || abs(b) > 2^{23} || abs(a) > 2^{23})\). To get proper statistics for this case,
use the oneapi::mkl::rng::uniform_method::accurate
method instead.
Input Parameters#
Name |
Type |
Description |
---|---|---|
|
|
Left bound |
|
|
Right bound |