beta

oneMKL - Data Parallel C++ Developer Reference

Download PDF

ID 772045

Date 6/24/2024

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-1F8B0AA4-3AF2-496A-8D63-313D50FAD69D

View Details

beta

Generates Beta distributed random numbers.

Description
API

Description

The beta class object is used in the generate function to provide random numbers with beta distribution that has shape parameters and , displacement , and scale parameter , where , , , .

The probability density function is given by:

The cumulative distribution function is as follows:

Where is the complete beta function.

API

Syntax

namespace oneapi::mkl::rng::device {
  template<typename RealType, typename Method>
  class beta {
  public:
    using method_type = Method;
    using result_type = RealType;

    beta() : beta((RealType)1.0, (RealType)1.0, (RealType)0.0, (RealType)1.0){}
    explicit beta(RealType p, RealType q, RealType a, RealType b);
    explicit beta(const param_type& pt);

    RealType p() const;
    RealType q() const;
    RealType a() const;
    RealType b() const;
    param_type param() const;
    std::size_t count_rejected_numbers() const;
    void param(const param_type& pt);
  };
}

Include Files

oneapi/mkl/rng/device.hpp

Template Parameters

typename Type

Type of the produced values. The specific values are as follows:

float
double

typename Method

Generation method. The specific values are as follows:

oneapi::mkl::rng::device::beta_method::by_default
oneapi::mkl::rng::device::beta_method::cja
oneapi::mkl::rng::device::beta_method::cja_accurate

See brief descriptions of the methods in Distributions Template Parameter Method

NOTE:

To enable extra optimizations based on Vector Math functions, define the MKL_RNG_USE_BINARY_CODE macro and link static oneMKL libraries according to the output produced by Intel® oneAPI Math Kernel Library Link Line Advisor. It may improve performance on some hardware.

Input Parameters

Name	Type	Description
p	`RealType (float, double)`	Shape `p`.
q	`RealType (float, double)`	Shape `q`.
a	`RealType (float, double)`	Displacement .
b	`RealType (float, double)`	Scalefactor .

Special methods

std::size_t count_rejected_numbers() const

Returns the amount of random numbers that were rejected during the last generate function call. If no generate calls, returns 0.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

oneMKL - Data Parallel C++ Developer Reference

beta

Description

API