Classe lognormal_distribution
Genera una distribuzione lognormale.
Sintassi
template <class RealType = double>
class lognormal_distribution
{
public:
// types
typedef RealType result_type;
struct param_type;
// constructor and reset functions
explicit lognormal_distribution(result_type m = 0.0, result_type s = 1.0);
explicit lognormal_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 m() const;
result_type s() const;
param_type param() const;
void param(const param_type& parm);
result_type min() const;
result_type max() const;
};
Parametri
RealType
Tipo di risultato a virgola mobile. Per impostazione predefinita, double. Per i tipi possibili, vedere casuale>.<
Osservazioni:
Il modello di classe descrive una distribuzione che produce valori di un tipo integrale specificato dall'utente oppure un tipo double se non ne viene specificato alcuno, distribuito in base alla distribuzione normale del log. La tabella seguente include collegamenti ad articoli relativi ai singoli membri.
lognormal_distribution
param_type
Le funzioni di proprietà m() e s() restituiscono i valori per i parametri di distribuzione archiviati, rispettivamente m e s.
Il membro di proprietà param() imposta o restituisce il pacchetto di parametri di distribuzione archiviato param_type.
Le funzioni membro min() e max() restituiscono rispettivamente il minor risultato possibile e il maggior risultato possibile.
La funzione membro reset() rimuove gli eventuali valori memorizzati nella cache, in modo che il risultato della successiva chiamata a operator() non dipenda da alcun valore ottenuto dal motore prima della chiamata.
Le funzioni membro operator() restituiscono il successivo valore generato basato sul motore URNG, dal pacchetto di parametri corrente o da quello specificato.
Per altre informazioni sulle classi di distribuzione e sui relativi membri, vedere casuale>.<
Per informazioni dettagliate sulla distribuzione LogNormal, vedere l'articolo di Wolfram MathWorld LogNormal Distribution (Distribuzione LogNormal).
Esempio
// compile with: /EHsc /W4
#include <random>
#include <iostream>
#include <iomanip>
#include <string>
#include <map>
using namespace std;
void test(const double m, const double s, const int samples) {
// uncomment to use a non-deterministic seed
// random_device gen;
// mt19937 gen(rd());
mt19937 gen(1701);
lognormal_distribution<> distr(m, s);
cout << endl;
cout << "min() == " << distr.min() << endl;
cout << "max() == " << distr.max() << endl;
cout << "m() == " << fixed << setw(11) << setprecision(10) << distr.m() << endl;
cout << "s() == " << fixed << setw(11) << setprecision(10) << distr.s() << endl;
// generate the distribution as a histogram
map<double, int> histogram;
for (int i = 0; i < samples; ++i) {
++histogram[distr(gen)];
}
// print results
cout << "Distribution for " << samples << " samples:" << endl;
int counter = 0;
for (const auto& elem : histogram) {
cout << fixed << setw(11) << ++counter << ": "
<< setw(14) << setprecision(10) << elem.first << endl;
}
cout << endl;
}
int main()
{
double m_dist = 1;
double s_dist = 1;
int samples = 10;
cout << "Use CTRL-Z to bypass data entry and run using default values." << endl;
cout << "Enter a floating point value for the 'm' distribution parameter: ";
cin >> m_dist;
cout << "Enter a floating point value for the 's' distribution parameter (must be greater than zero): ";
cin >> s_dist;
cout << "Enter an integer value for the sample count: ";
cin >> samples;
test(m_dist, s_dist, samples);
}
Use CTRL-Z to bypass data entry and run using default values.
Enter a floating point value for the 'm' distribution parameter: 0
Enter a floating point value for the 's' distribution parameter (must be greater than zero): 1
Enter an integer value for the sample count: 10
min() == -1.79769e+308
max() == 1.79769e+308
m() == 0.0000000000
s() == 1.0000000000
Distribution for 10 samples:
1: 0.3862809339
2: 0.4128865601
3: 0.4490576787
4: 0.4862035428
5: 0.5930607126
6: 0.8190778771
7: 0.8902379317
8: 2.8332911667
9: 5.1359445565
10: 5.4406507912
Requisiti
Intestazione:<casuale>
Spazio dei nomi: std
lognormal_distribution::lognormal_distribution
Costruisce la distribuzione.
explicit lognormal_distribution(RealType m = 0.0, RealType s = 1.0);
explicit lognormal_distribution(const param_type& parm);
Parametri
m
Parametro di distribuzione m.
s
Parametro di distribuzione s.
parm
Struttura param_type usata per costruire la distribuzione.
Osservazioni:
Precondizione:0.0 < s
Il primo costruttore crea un oggetto il cui valore m archiviato include il valore m e il cui valore s archiviato include il valore s.
Il secondo costruttore crea un oggetto i cui parametri archiviati sono inizializzati da parm. È possibile ottenere e impostare i parametri correnti di una distribuzione esistente chiamando la funzione membro param().
lognormal_distribution::param_type
Archivia i parametri della distribuzione.
struct param_type {
typedef lognormal_distribution<result_type> distribution_type;
param_type(result_type m = 0.0, result_type s = 1.0);
result_type m() const;
result_type s() const;
bool operator==(const param_type& right) const;
bool operator!=(const param_type& right) const;
};
Parametri
m
Parametro di distribuzione m.
s
Parametro di distribuzione s.
right
Struttura param_type usata per il confronto.
Osservazioni:
Precondizione:0.0 < s
Questa struttura può essere passata al costruttore di classe della distribuzione durante la creazione di istanze, alla funzione membro param() per impostare i parametri archiviati di una distribuzione esistente e a operator() per l'uso in sostituzione dei parametri archiviati.