Namespaces
Variants

std:: exponential_distribution

From cppreference.net
C++
Numerics library
Pseudo-random number generation
Random number distributions
Uniform distributions
(C++11)
(C++11)
(C++11)
Bernoulli distributions
(C++11)
(C++11)
(C++11)
(C++11)
Poisson distributions
(C++11)
exponential_distribution
(C++11)
(C++11)
(C++11)
(C++11)
Normal distributions
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Sampling distributions
(C++11)
(C++11)
(C++11)
std::exponential_distribution
Definiert im Header <random>
template < class RealType = double >
class exponential_distribution ;
(seit C++11)

Erzeugt zufällige nicht-negative Gleitkommawerte x , verteilt gemäß der Wahrscheinlichkeitsdichtefunktion:

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

Der erhaltene Wert ist die Zeit/Entfernung bis zum nächsten Zufallsereignis, wenn Zufallsereignisse mit konstanter Rate λ pro Zeiteinheit/Entfernungseinheit auftreten. Beispielsweise beschreibt diese Verteilung die Zeit zwischen den Klicks eines Geigerzählers oder die Entfernung zwischen Punktmutationen in einem DNA-Strang.

Dies ist das kontinuierliche Gegenstück von std::geometric_distribution .

std::exponential_distribution erfüllt die Anforderungen von RandomNumberDistribution .

Inhaltsverzeichnis

Template-Parameter

RealType - Der vom Generator erzeugte Ergebnistyp. Das Verhalten ist undefiniert, falls dies nicht einer der Typen float , double , oder long double ist.

Mitgliedertypen

Mitgliedertyp Definition
result_type (C++11) RealType
param_type (C++11) der Typ des Parametersatzes, siehe RandomNumberDistribution .

Memberfunktionen

(C++11)
Konstruiert eine neue Verteilung
(öffentliche Elementfunktion)
(C++11)
setzt den internen Zustand der Verteilung zurück
(öffentliche Elementfunktion)
Erzeugung
(C++11)
erzeugt die nächste Zufallszahl in der Verteilung
(öffentliche Elementfunktion)
Eigenschaften
(C++11)
gibt den lambda Verteilungsparameter zurück (Ereignisrate)
(öffentliche Elementfunktion)
(C++11)
ruft das Verteilungsparameterobjekt ab oder setzt es
(öffentliche Elementfunktion)
(C++11)
gibt den minimal möglichen generierten Wert zurück
(öffentliche Elementfunktion)
(C++11)
gibt den maximal möglichen generierten Wert zurück
(öffentliche Elementfunktion)

Nicht-Member-Funktionen

(C++11) (C++11) (entfernt in C++20)
vergleicht zwei Verteilungsobjekte
(Funktion)
(C++11)
führt Stream-Eingabe und -Ausgabe auf Pseudo-Zufallszahlenverteilung durch
(Funktionsschablone)

Hinweise

Einige Implementierungen können gelegentlich Unendlich zurückgeben, wenn RealType als float definiert ist. Dies ist LWG issue 2524 .

Beispiel

Diesen Code ausführen 
#include <iomanip>
#include <iostream>
#include <map>
#include <random>
#include <string>
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    // wenn Teilchen durchschnittlich einmal pro Sekunde zerfallen,
    // wie viel Zeit in Sekunden vergeht bis zum nächsten Zerfall?
    std::exponential_distribution<> d(1);
    std::map<int, int> hist;
    for (int n = 0; n != 10000; ++n)
        ++hist[2 * d(gen)];
    for (auto const& [x, y] : hist)
        std::cout << std::fixed << std::setprecision(1)
                  << x / 2.0 << '-' << (x + 1) / 2.0 << ' '
                  << std::string(y / 200, '*') << '\n';
}

Mögliche Ausgabe: 

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

Externe Links

Weisstein, Eric W. "Exponential Distribution." Von MathWorld — Eine Wolfram Web Resource.