lognormal#

対数正規分布の乱数を生成します。

説明#

lognormal クラス・オブジェクトは、generate 関数で使用され、対象の正規分布の分布の平均 (ma) と標準偏差 (sσ)、変位 (displb)、スケール係数 (scaleβ) を持つ乱数を生成します。ここで、\(a, \sigma, b, \beta \in R; \sigma, \beta > 0;\) です。

確率密度関数は次のように表されます。

\[\begin{split}f_{a, \sigma, b, \beta} (x) = \begin{cases} \frac{1}{\sigma (x - b) \sqrt {2\pi}} \exp \left( -\frac{\ln( \frac{x - b}{\beta}) - a)^2}{2\sigma^2} \right), & x > b \\ 0, & x \leq b \end{cases}\end{split}\]

累積分布関数は次のようになります。

\[\begin{split}F_{a, \sigma, b, \beta} (x) = \begin{cases} \Phi \left(\frac{\ln( \frac{x - b}{\beta}) - a}{\sigma} \right), & x > b \\ 0, & x \leq b \end{cases}\end{split}\]

API#

構文#

namespace oneapi::mkl::rng { 
  template<typename RealType = float, 
           typename Method = lognormal_method::by_default> 
  class lognormal { 
  public: 
    using method_type = Method; 
    using result_type = RealType; 

    lognormal(): lognormal((RealType)0.0, (RealType)1.0, 
                           (RealType) 0.0, (RealType)1.0){} 
    explicit lognormal(RealType m, RealType s, 
                       RealType displ = (RealType)0.0, 
                       RealType scale = (RealType)1.0); 
    explicit lognormal(const param_type& pt); 

    RealType m() const; 
    RealType s() const; 
    RealType displ() const; 
    RealType scale() const; 
    param_type param() const; 
    void param(const param_type& pt); 
  }; 
}

サポートされるデバイス: CPU と GPU。

インクルード・ファイル#

  • oneapi/mkl/rng.hpp

テンプレート・パラメーター#

typename RealType = float

生成された値のタイプ。固有の値は次のとおりです:

float

double

typename Method = oneapi::mkl::rng::lognormal_method::by_default

生成メソッド。固有の値は次のとおりです:

oneapi::mkl::rng::lognormal_method::box_muller2

oneapi::mkl::rng::lognormal_method::box_muller2_accurate

oneapi::mkl::rng::lognormal_method::icdf

oneapi::mkl::rng::lognormal_method::icdf_accurate

配布テンプレート・パラメーター・メソッドのメソッドの説明を参照してください。

入力パラメーター#

名前

タイプ

説明

m

RealType (float, double)

対象の正規分布の平均 a

s

RealType (float, double)

対象正規分布の標準偏差 σ

displ

RealType (float, double)

変位 displ

scale

RealType (float, double)

スケール係数 scale