Namespaces
Variants

std:: normal_distribution

From cppreference.net
C++
Numerics library
Pseudo-random number generation
Random number distributions
Uniform distributions
(C++11)
(C++11)
(C++11)
Bernoulli distributions
(C++11)
(C++11)
(C++11)
(C++11)
Poisson distributions
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Normal distributions
normal_distribution
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Sampling distributions
(C++11)
(C++11)
(C++11)
std::normal_distribution
ヘッダーで定義 <random>
template < class RealType = double >
class normal_distribution ;
(C++11以降)

正規分布（またはガウス分布） に従う乱数を生成します。これは次のように定義されます：

f(x; μ,σ) =
1
σ √ 2π
exp ⎛
⎜
⎝
-1
2
⎛
⎜
⎝
x-μ
σ
⎞
⎟
⎠ 2
⎞
⎟
⎠

ここで μ は 平均 であり、 σ は 標準偏差 ( stddev ) です。

std::normal_distribution は RandomNumberDistribution のすべての要件を満たします。

目次

テンプレートパラメータ

RealType - ジェネレータによって生成される結果の型。これが float 、 double 、または long double のいずれでもない場合、動作は未定義です。

メンバー型

メンバー型 定義
result_type (C++11) RealType
param_type (C++11) パラメータセットの型、 RandomNumberDistribution を参照。

メンバー関数

(C++11)
新しい分布を構築する
(public member function)
(C++11)
分布の内部状態をリセットする
(public member function)
生成
(C++11)
分布における次の乱数を生成する
(public member function)
特性
(C++11)
分布パラメータを返す
(public member function)
(C++11)
分布パラメータオブジェクトを取得または設定する
(public member function)
(C++11)
生成されうる最小値を返す
(public member function)
(C++11)
生成されうる最大値を返す
(public member function)

非メンバー関数

(C++11) (C++11) (removed in C++20)
2つの分布オブジェクトを比較する
(関数)
(C++11)
擬似乱数分布に対するストリーム入出力を実行する
(関数テンプレート)

例

このコードを実行 
#include <cmath>
#include <iomanip>
#include <iostream>
#include <map>
#include <random>
#include <string>
int main()
{
    std::random_device rd{};
    std::mt19937 gen{rd()};
    // 平均値付近の値が最も発生しやすい。標準偏差は
    // 生成される値の平均からのばらつきに影響する。
    std::normal_distribution d{5.0, 2.0};
    // 正規分布からサンプルを抽出し、整数に丸める。
    auto random_int = [&d, &gen]{ return std::lround(d(gen)); };
    std::map<long, unsigned> histogram{};
    for (auto n{10000}; n; --n)
        ++histogram[random_int()];
    for (const auto [k, v] : histogram)
        std::cout << std::setw(2) << k << ' ' << std::string(v / 200, '*') << '\n';
}

出力例: 

-1
 0
 1 *
 2 ***
 3 *****
 4 ********
 5 *********
 6 *********
 7 ******
 8 ***
 9 *
10
11

外部リンク

1. Weisstein, Eric W. "Normal Distribution." MathWorld — Wolfram Web リソースより。
2. Normal distribution — Wikipediaより。