std::normal_distribution

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

数値演算ライブラリ

一般的な数学関数

数学の特殊関数 (C++17)

数学定数 (C++20)

浮動小数点環境 (C++11)

複素数

数値配列

擬似乱数生成

コンパイル時有理数算術 (C++11)

数値演算アルゴリズム

gcd (C++17)

lcm (C++17)

補間

midpoint (C++20)

lerp (C++20)

汎用の数値演算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

ビット操作

bit_cast (C++20)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

擬似乱数生成

一様ランダムビットジェネレータ

uniform_random_bit_generator (C++20)

エンジンとエンジンアダプタ

linear_congruential_engine (C++11)

mersenne_twister_engine (C++11)

subtract_with_carry_engine (C++11)

discard_block_engine (C++11)

independent_bits_engine (C++11)

shuffle_order_engine (C++11)

非決定的なジェネレータ

random_device (C++11)

分布

一様分布

uniform_int_distribution (C++11)

uniform_real_distribution (C++11)

generate_canonical (C++11)

ベルヌーイ分布

bernoulli_distribution (C++11)

binomial_distribution (C++11)

negative_binomial_distribution (C++11)

geometric_distribution (C++11)

ポアソン分布

poisson_distribution (C++11)

exponential_distribution (C++11)

gamma_distribution (C++11)

weibull_distribution (C++11)

extreme_value_distribution (C++11)

正規分布

normal_distribution (C++11)

lognormal_distribution (C++11)

chi_squared_distribution (C++11)

cauchy_distribution (C++11)

fisher_f_distribution (C++11)

student_t_distribution (C++11)

標本分布

discrete_distribution (C++11)

piecewise_constant_distribution (C++11)

piecewise_linear_distribution (C++11)

シードシーケンス

seed_seq (C++11)

C のライブラリ

rand

srand

RAND_MAX

 

std::normal_distribution

メンバ関数

normal_distribution::normal_distribution

normal_distribution::reset

生成

normal_distribution::operator()

特性

normal_distribution::meannormal_distribution::stddev

normal_distribution::param

normal_distribution::min

normal_distribution::max

非メンバ関数

operator==operator!=

operator<<operator>>

 

<tbody> </tbody>

ヘッダ <random> で定義
template< class RealType = double > class normal_distribution;		(C++11以上)

正規 (ガウス) 分布に従った乱数を生成します。 以下のように定義されます。

f(x; μ,σ) =

1

σ√2π

exp⎛
⎜
⎝

-1

2

⎛
⎜
⎝

x-μ

σ

⎞
⎟
⎠2
⎞
⎟
⎠

ここで μ は平均、 σ は標準偏差です。

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

テンプレート引数

RealType

-

ジェネレータが生成する結果の型。 float、 double または long double のいずれかでない場合、効果は未定義です

メンバ型

メンバ型	定義
result_type	RealType
param_type	パラメータセットの型、 RandomNumberDistribution を参照してください

メンバ関数

コンストラクタ	新しい分布を構築します (パブリックメンバ関数)
reset	分布の内部状態をリセットします (パブリックメンバ関数)
生成
operator()	分布の次の乱数を生成します (パブリックメンバ関数)
特性
meanstddev	分布のパラメータを返します (パブリックメンバ関数)
param	分布のパラメータオブジェクトを取得または設定します (パブリックメンバ関数)
min	生成される可能性のある最小値を返します (パブリックメンバ関数)
max	生成される可能性のある最大値を返します (パブリックメンバ関数)

非メンバ関数

operator==operator!=	2つの分布オブジェクトを比較します (関数)
operator<<operator>>	乱数分布に対してストリーム入出力を行います (関数テンプレート)

例

Run this code

#include <iostream>
#include <iomanip>
#include <string>
#include <map>
#include <random>
#include <cmath>
int main()
{
    std::random_device rd{};
    std::mt19937 gen{rd()};

    // values near the mean are the most likely
    // standard deviation affects the dispersion of generated values from the mean
    std::normal_distribution<> d{5,2};

    std::map<int, int> hist{};
    for(int n=0; n<10000; ++n) {
        ++hist[std::round(d(gen))];
    }
    for(auto p : hist) {
        std::cout << std::setw(2)
                  << p.first << ' ' << std::string(p.second/200, '*') << '\n';
    }
}

出力例:

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

外部リンク

• Weisstein, Eric W. "Normal Distribution." From MathWorld--A Wolfram Web Resource.
• Normal Distribution. From Wikipedia.