Classe binomial_distribution
Gera uma distribuição Binomial.
Sintaxe
template<class IntType = int>
class binomial_distribution
{
public:
// types
typedef IntType result_type;
struct param_type;
// constructors and reset functions
explicit binomial_distribution(result_type t = 1, double p = 0.5);
explicit binomial_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
result_type t() const;
double p() const;
param_type param() const;
void param(const param_type& parm);
result_type min() const;
result_type max() const;
};
Parâmetros
IntType
O tipo de resultado do inteiro assume int como padrão. Para encontrar os tipos possíveis, confira <random>.
URNG
O mecanismo gerador de números aleatórios uniformes. Para encontrar os tipos possíveis, confira <random>.
Comentários
O modelo de classe descreve uma distribuição que gera valores de um tipo integral especificado pelo usuário ou do tipo int se não houver nenhuma especificação. Esses valores são distribuídos de acordo com a função de probabilidade discreta distribuição Binomial. A tabela a seguir contém links para artigos sobre cada um dos membros.
binomial_distribution
param_type
Os membros de propriedade t() e p() retornam os valores do parâmetro de distribuição armazenados t e p, respectivamente.
O membro da propriedade param() define ou retorna o pacote de parâmetros de distribuição armazenado param_type.
As funções membro min() e max() retornam o menor resultado possível e o maior resultado possível, respectivamente.
A função membro reset() descarta qualquer valor armazenado em cache, de forma que o resultado da próxima chamada para operator() não dependerá dos valores obtidos do mecanismo antes da chamada.
As funções membro operator() retornam o próximo valor gerado com base no mecanismo URNG, do pacote de parâmetros atual ou do pacote de parâmetros especificado.
Para obter mais informações sobre as classes de distribuição e seus membros, confira <random>.
Para obter informações detalhadas sobre a função de probabilidade discreta da distribuição binomial, consulte o artigo da Wolfram MathWorld Binomial Distribution (Distribuição Binomial).
Exemplo
// compile with: /EHsc /W4
#include <random>
#include <iostream>
#include <iomanip>
#include <string>
#include <map>
void test(const int t, 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::binomial_distribution<> distr(t, p);
std::cout << std::endl;
std::cout << "p == " << distr.p() << std::endl;
std::cout << "t == " << distr.t() << std::endl;
// generate the distribution as a histogram
std::map<int, 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::setw(5) << elem.first << ' ' << std::string(elem.second, ':') << std::endl;
}
std::cout << std::endl;
}
int main()
{
int t_dist = 1;
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 an integer value for t distribution (where 0 <= t): ";
std::cin >> t_dist;
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(t_dist, p_dist, samples);
}
Primeira execução:
Use CTRL-Z to bypass data entry and run using default values.
Enter an integer value for t distribution (where 0 <= t): 22
Enter a double value for p distribution (where 0.0 <= p <= 1.0): .25
Enter an integer value for a sample count: 100
p == 0.25
t == 22
Histogram for 100 samples:
1 :
2 ::
3 :::::::::::::
4 ::::::::::::::
5 :::::::::::::::::::::::::
6 ::::::::::::::::::
7 :::::::::::::
8 ::::::
9 ::::::
11 :
12 :
Segunda execução:
Use CTRL-Z to bypass data entry and run using default values.
Enter an integer value for t distribution (where 0 <= t): 22
Enter a double value for p distribution (where 0.0 <= p <= 1.0): .5
Enter an integer value for a sample count: 100
p == 0.5
t == 22
Histogram for 100 samples:
6 :
7 ::
8 :::::::::
9 ::::::::::
10 ::::::::::::::::
11 :::::::::::::::::::
12 :::::::::::
13 :::::::::::::
14 :::::::::::::::
15 ::
16 ::
Terceira execução:
Use CTRL-Z to bypass data entry and run using default values.
Enter an integer value for t distribution (where 0 <= t): 22
Enter a double value for p distribution (where 0.0 <= p <= 1.0): .75
Enter an integer value for a sample count: 100
p == 0.75
t == 22
Histogram for 100 samples:
13 ::::
14 :::::::::::
15 :::::::::::::::
16 :::::::::::::::::::::
17 ::::::::::::::
18 :::::::::::::::::
19 :::::::::::
20 ::::::
21 :
Requisitos
Cabeçalho:<random>
Namespace: std
binomial_distribution::binomial_distribution
Constrói a distribuição.
explicit binomial_distribution(result_type t = 1, double p = 0.5);
explicit binomial_distribution(const param_type& parm);
Parâmetros
t
O parâmetro de distribuição t.
p
O parâmetro de distribuição p.
parm
A estrutura param_type usada para construir a distribuição.
Comentários
Condição prévia: 0 ≤ t e 0.0 ≤ p ≤ 1.0
O primeiro construtor constrói um objeto cujo valor de p armazenado conterá o valor de p e cujo valor de t armazenado conterá o valor de t.
O segundo construtor cria um objeto cujos parâmetros armazenados são inicializados de parm. Você pode chamar a função de membro param() para obter e definir os parâmetros atuais de uma distribuição existente.
binomial_distribution::param_type
Armazena todos os parâmetros da distribuição.
struct param_type {
typedef binomial_distribution<result_type> distribution_type;
param_type(result_type t = 1, double p = 0.5);
result_type t() const;
double p() const;
.....
bool operator==(const param_type& right) const;
bool operator!=(const param_type& right) const;
};
Parâmetros
t
O parâmetro de distribuição t.
p
O parâmetro de distribuição p.
direita
O objeto param_type a ser comparado a este.
Comentários
Condição prévia: 0 ≤ t e 0.0 ≤ p ≤ 1.0
Essa estrutura pode ser enviada ao construtor de classe de distribuição na instanciação, para a função de membro param() para definir os parâmetros armazenados de uma distribuição existente e para operator() a ser usado no lugar dos parâmetros armazenados.