oneapi::mkl::rng::device::uniform (Discrete)

oneMKL - Data Parallel C++ Developer Reference

Download PDF

ID 772045

Date 7/13/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-0E8F8930-20B0-4964-A8A7-F7BE2D147867

View Details

oneapi::mkl::rng::device::uniform (Discrete)

Generates random numbers uniformly distributed over the interval [a, b).

Description
API

Description

The oneapi::mkl::rng::device::uniform class object is used in oneapi::mkl::rng::device::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 .

The probability distribution is given by:

The cumulative distribution function is as follows:

API

Syntax

template<typename Type, typename Method>
class uniform<std::(u)int32_t, Method> {
public:
  using method_type = Method;
  using result_type = Type;
  uniform(): uniform((Type)0,
                std::is_same<Method,
                uniform_method::standard>::value ? (1 << 23) :
                std::numeric_limits<Type>::max()){};
  explicit uniform(Type a, Type b);
  explicit uniform(const param_type& pt);
  Type a() const;
  Type b() const;
  param_type param() const;
  void param(const param_type& pt);
};

Include Files

oneapi/mkl/rng/device.hpp

Template Parameters

typename Method

Generation method. The specific values are as follows:

oneapi::mkl::rng::device::uniform_method::standard

oneapi::mkl::rng::device::uniform_method::accurate

See brief descriptions of the methods in Distributions Template Parameter Method.

NOTE:

The oneapi::mkl::rng::device::uniform_method::standard uses the s BRNG type. This might cause the produced numbers to have incorrect statistics (due to rounding error) when

. To get proper statistics for this case, use the oneapi::mkl::rng::device::uniform_method::accurate method instead.

Input Parameters

Name	Type	Description
a	`std::int32_t` `std::uint32_t`	Left bound `a`
b	`std::int32_t` `std::uint32_t`	Right bound `b`

Name

Type

Description

std::int32_t

std::uint32_t

Left bound a

std::int32_t

std::uint32_t

Right bound b

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

oneMKL - Data Parallel C++ Developer Reference

oneapi::mkl::rng::device::uniform (Discrete)

Description

API