std::exponential_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::exponential_distribution

メンバ関数

exponential_distribution::exponential_distribution

exponential_distribution::reset

生成

exponential_distribution::operator()

特性

exponential_distribution::lambda

exponential_distribution::param

exponential_distribution::min

exponential_distribution::max

非メンバ関数

operator==operator!=

operator<<operator>>

 

<tbody> </tbody>

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

以下の確率密度関数に従って分布する、ランダムな非負の浮動小数点値 x を生成します。

P(x|λ) = λe-λx

取得される値は、単位時間/距離あたり λ の割合でランダムな事象が発生する場合の、次にその事象が発生するまでの時間/距離です。 例えば、この分布はガイガーカウンターの音が鳴る間隔、あるいは DNA の螺旋構造の点変異間の距離などを表します。

これは std::geometric_distribution の連続版です。

std::exponential_distribution は RandomNumberDistribution を満たします。

テンプレート引数

RealType

-

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

メンバ型

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

メンバ関数

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

非メンバ関数

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

ノート

いくつかの処理系は RealType が float の場合に、時折、無限大を返すことがあります。 LWG issue 2524 を参照してください。

例

Run this code

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

    // if particles decay once per second on average,
    // how much time, in seconds, until the next one?
    std::exponential_distribution<> d(1);
 
    std::map<int, int> hist;
    for(int n=0; n<10000; ++n) {
        ++hist[2*d(gen)];
    }
    for(auto p : hist) {
        std::cout << std::fixed << std::setprecision(1) 
                  << p.first/2.0 << '-' << (p.first+1)/2.0 <<
                ' ' << std::string(p.second/200, '*') << '\n';
    }
}

出力例:

0.0-0.5 *******************
0.5-1.0 ***********
1.0-1.5 *******
1.5-2.0 ****
2.0-2.5 **
2.5-3.0 *
3.0-3.5 
3.5-4.0

外部リンク

Weisstein, Eric W. "Exponential Distribution." From MathWorld--A Wolfram Web Resource.