bernoulli_distribution クラス

  • [アーティクル]

ベルヌイ分布を生成します。

構文

class bernoulli_distribution
   {
public:
   // types
   typedef bool result_type;
   struct param_type;

   // constructors and reset functions
   explicit bernoulli_distribution(double p = 0.5);
   explicit bernoulli_distribution(const param_type& parm);
   void reset();

   // generating functions
   template <class URNG>
   result_type operator()(URNG& gen);
   template <class URNG>
   result_type operator()(URNG& gen, const param_type& parm);

   // property functions
   double p() const;
   param_type param() const;
   void param(const param_type& parm);
   result_type min() const;
   result_type max() const;
   };

パラメーター

URNG
Uniform Random Number Generator エンジン。 使用可能な型については、「<random>」を参照してください。

解説

このクラスは、ベルヌイ分布の離散確率関数に従って分布した、型 bool の値を生成する分布を表します。 次の表は、個々のメンバーに関する記事にリンクしています。

bernoulli_distribution
param_type

プロパティ メンバー p() は、現在格納されている分布パラメーター値 p を返します。

プロパティ メンバー param() は、格納されている分布パラメーター パッケージ param_type を設定または返します。

メンバー関数の min() と max() はそれぞれ、考えられる結果の最小値と最大値を返します。

reset() メンバー関数は、次回 operator() を呼び出したときに、その結果が、その前にエンジンから取得された値に左右されないようにするため、キャッシュされている値をすべて破棄します。

operator() メンバー関数は、現在のパラメーター パッケージと指定したパラメーター パッケージのいずれかから、URNG エンジンに基づいて次に生成された値を返します。

分布クラスとそのメンバーの詳細については、<random> をご覧ください。

ベルヌイ分布の離散確率関数の詳細については、Wolfram MathWorld の記事「ベルヌイ分布」を参照してください。

例

// compile with: /EHsc /W4
#include <random>
#include <iostream>
#include <iomanip>
#include <string>
#include <map>

void test(const double p, const int s) {

    // uncomment to use a non-deterministic seed
    //    std::random_device rd;
    //    std::mt19937 gen(rd());
    std::mt19937 gen(1729);

    std::bernoulli_distribution distr(p);

    std::cout << "p == " << distr.p() << std::endl;

    // generate the distribution as a histogram
    std::map<bool, int> histogram;
    for (int i = 0; i < s; ++i) {
        ++histogram[distr(gen)];
    }

    // print results
    std::cout << "Histogram for " << s << " samples:" << std::endl;
    for (const auto& elem : histogram) {
        std::cout << std::boolalpha << std::setw(5) << elem.first << ' ' << std::string(elem.second, ':') << std::endl;
    }
    std::cout << std::endl;
}

int main()
{
    double p_dist = 0.5;
    int samples = 100;

    std::cout << "Use CTRL-Z to bypass data entry and run using default values." << std::endl;
    std::cout << "Enter a double value for p distribution (where 0.0 <= p <= 1.0): ";
    std::cin >> p_dist;
    std::cout << "Enter an integer value for a sample count: ";
    std::cin >> samples;

    test(p_dist, samples);
}

Use CTRL-Z to bypass data entry and run using default values.
Enter a double value for p distribution (where 0.0 <= p <= 1.0): .45
Enter an integer value for a sample count: 100
p == 0.45
Histogram for 100 samples:
false :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
true :::::::::::::::::::::::::::::::::::::::::

要件

ヘッダー: <random>

名前空間: std

bernoulli_distribution::bernoulli_distribution

分布を作成します。

explicit bernoulli_distribution(double p = 0.5);
explicit bernoulli_distribution(const param_type& parm);

パラメーター

P
格納されている p 分布パラメーター。

parm
分布の作成に使用される param_type の構造体。

解説

前提条件: 0.0 ≤ p ≤ 1.0

1 つ目のコンストラクターは、格納されている p の値が p の値を保持するオブジェクトを作成します。

2 つ目のコンストラクターは、格納パラメーターが parm から初期化されるオブジェクトを作成します。 param() メンバー関数を呼び出すと、既存の分布の現在のパラメーターを取得および設定できます。

bernoulli_distribution::param_type

分布のパラメーターを含みます。

struct param_type { typedef bernoulli_distribution distribution_type; param_type(double p = 0.5); double p() const;

bool operator==(const param_type& right) const; bool operator!=(const param_type& right) const; };

パラメーター

P
格納されている p 分布パラメーター。

解説

前提条件: 0.0 ≤ p ≤ 1.0

この構造体は、インスタンス化時に分布のクラス コンストラクターに渡したり、param() メンバー関数に渡して、既存の分布の格納されているパラメーターを設定したり、operator() に渡して、格納されているパラメーターの代わりに使用したりすることができます。

関連項目

<random>