Klasse StdRandom
java.lang.Object
StdLib.StdRandom
Statistische Methoden zur Generierung von Zufallszahlen sowie diskreten und stetigen Verteilungen. Der Startwert
für den Zufallsgenerator wird standardmäßig auf die Anzahl der seit Beginn 1970 vergangenen Millisekunden gesetzt.
So wird gewährleistet, bei jedem Programmlauf unterschiedliche Sequenzen von Zufallszahlen zu generieren.
Hinweis: Die Funktionalität und Namenskonventionen dieser Bibliothek orientieren sich an der bewährten "StdLib" der Princeton University (Sedgewick/Wayne), wurden jedoch vollständig neu und modern implementiert.
- Version:
- 1.0 (2026-10-11)
- Autor:
- Karsten Brodmann (karsten.brodmann@osnanet.de)
-
Methodenübersicht
Modifikator und TypMethodeBeschreibungstatic booleanErzeugung eines zufälligen Bernoulli-Verteilten Wahrheitswertes mit der Wahrscheinlichkeit 0.5.static booleanbernoulli(double p) Erzeugung eines zufälligen Bernoulli-Verteilten Wahrheitswertes.static intbinomial(int n, double p) Erzeugt eine binomialverteilte Zufallszahl \(B(n, p)\).static intdiscrete(double[] p) Gibt einen zufälligenint-Wert von der diskreten Verteilung zurück, die das Arraypdefiniert.static doubleexponential(double lambda) Generiert einen exponentialverteilten Zufallswert für eine gegebene Rate λ.static doublegaussian()Erzeugt eine standardnormalverteilte Zufallszahl mit Erwartungswert 0 und Standardabweichung 1.static doublegaussian(double mu, double sigma) Erzeugt eine normalverteilte Zufallszahl.static intgeometric(double p) Erzeugt eine geometrisch verteilte Zufallszahl.static intpoisson(double lambda) Poisson-verteilter Zufallswert (ganzzahlig) mit Erwartungswert λ.static voidZurücksetzen des Startwertes für den Zufallsgenerator auf die Standardeinstellungen.static voidsetSeed(long seed) Setzen des Startwertes für den Zufallsgenerator.static doubleuniform()Gleich verteilte Gleitkommazahl (double) im Intervall [0, 1).static doubleuniform(double hi) Gleich verteile Gleitkommazahl (double) im Intervall [0, hi).static doubleuniform(double lo, double hi) Gleich verteile Gleitkommazahl (double) im Intervall [lo, hi).static intuniform(int hi) Gleich verteile Ganzzahl (int) im Intervall [0, hi).static intuniform(int lo, int hi) Gleich verteile Ganzzahl (int) im Intervall [lo, hi).
-
Methodendetails
-
setSeed
public static void setSeed(long seed) Setzen des Startwertes für den Zufallsgenerator. Wird dieser auf einen bestimmten Wert gesetzt, produziert er stets die gleiche Sequenz von Zufallszahlen bei jeder Programmausführung.- Parameter:
seed- Startwert für Zufallsgenerator
-
resetSeed
public static void resetSeed()Zurücksetzen des Startwertes für den Zufallsgenerator auf die Standardeinstellungen. -
uniform
public static double uniform()Gleich verteilte Gleitkommazahl (double) im Intervall [0, 1).- Gibt zurück:
- Zufallszahl
-
uniform
public static double uniform(double hi) Gleich verteile Gleitkommazahl (double) im Intervall [0, hi).- Parameter:
hi- Obergrenze (exkludiert)- Gibt zurück:
- Zufallszahl
- Löst aus:
IllegalArgumentException- wenn Obergrenze kleiner gleich 0
-
uniform
public static double uniform(double lo, double hi) Gleich verteile Gleitkommazahl (double) im Intervall [lo, hi).- Parameter:
lo- Untergrenze (double)hi- Obergrenze (double)- Gibt zurück:
- Zufallszahl
- Löst aus:
IllegalArgumentException- wenn die Grenzen nicht endlich sind oder lo >= hi
-
uniform
public static int uniform(int hi) Gleich verteile Ganzzahl (int) im Intervall [0, hi).- Parameter:
hi- Obergrenze (int) [exkludiert]- Gibt zurück:
- Zufallszahl
- Löst aus:
IllegalArgumentException- wenn Obergrenze kleiner gleich 0
-
uniform
public static int uniform(int lo, int hi) Gleich verteile Ganzzahl (int) im Intervall [lo, hi).- Parameter:
lo- Untergrenze (int) [inkludiert]hi- Obergrenze (int) [exkludiert]- Gibt zurück:
- Zufallszahl
- Löst aus:
IllegalArgumentException- wenn Obergrenze kleiner gleich Untergrenze
-
gaussian
public static double gaussian()Erzeugt eine standardnormalverteilte Zufallszahl mit Erwartungswert 0 und Standardabweichung 1.Verwendet die Box-Muller-Transformation zur Erzeugung normalverteilter Zufallszahlen aus zwei unabhängigen, gleichverteilten Zufallszahlen.
- Gibt zurück:
- Zufallszahl
-
gaussian
public static double gaussian(double mu, double sigma) Erzeugt eine normalverteilte Zufallszahl.- Parameter:
mu- Erwartungswertsigma- Standardabweichung- Gibt zurück:
- Zufallszahl
-
bernoulli
public static boolean bernoulli(double p) Erzeugung eines zufälligen Bernoulli-Verteilten Wahrheitswertes.- Parameter:
p- Wahrscheinlichkeit- Gibt zurück:
truemit Wahrscheinlichkeitpundfalsemit Wahrscheinlichkeit1-p
-
bernoulli
public static boolean bernoulli()Erzeugung eines zufälligen Bernoulli-Verteilten Wahrheitswertes mit der Wahrscheinlichkeit 0.5.- Gibt zurück:
truemit Wahrscheinlichkeit 0.5 undfalsemit Wahrscheinlichkeit 0.5
-
geometric
public static int geometric(double p) Erzeugt eine geometrisch verteilte Zufallszahl. Die Zufallsvariable gibt die Anzahl der unabhängigen Bernoulli-Versuche bis zum ersten Erfolg an.Erzeugung einer geometrisch verteilten Zufallsvariablen mittels Inversionsmethode.
$$ X = \left\lfloor\frac{\ln U}{\ln(1-p)}\right\rfloor + 1 $$- Parameter:
p- Erfolgswahrscheinlichkeit (\(0 \lt p \leq 1\))- Gibt zurück:
- Anzahl der Versuche bis zum ersten Erfolg
- Löst aus:
IllegalArgumentException- bei ungültiger WahrscheinlichkeitArithmeticException- wenn das Ergebnis den Wertebereich vonintüberschreitet
-
poisson
public static int poisson(double lambda) Poisson-verteilter Zufallswert (ganzzahlig) mit Erwartungswert λ. Für λ ≥ 30 liefert die Methode nur Näherungswerte, die für Simulationen aber hinreichend sein sollten.- Parameter:
lambda- Lambda- Gibt zurück:
- Zufallswert
-
exponential
public static double exponential(double lambda) Generiert einen exponentialverteilten Zufallswert für eine gegebene Rate λ. Fängt unendliche Raten (λ = Infinity) sicher ab.- Parameter:
lambda- Rate (\(0 \lt \lambda \lt \inf\))- Gibt zurück:
- Zufallswert
-
binomial
public static int binomial(int n, double p) Erzeugt eine binomialverteilte Zufallszahl \(B(n, p)\). Simuliert \(n\) unabhängige Bernoulli-Versuche. Zeitkomplexität: O(n).- Parameter:
n- Anzahl der Versuchep- Erfolgswahrscheinlichkeit- Gibt zurück:
- Anzahl der Erfolge
-
discrete
public static int discrete(double[] p) Gibt einen zufälligenint-Wert von der diskreten Verteilung zurück, die das Arraypdefiniert.- Parameter:
p- diskrete Verteilung- Gibt zurück:
- Zufallswert
- Löst aus:
IllegalArgumentException- wennpgleichnullIllegalArgumentException- wenn die Summe der Wahrscheinlichkeiten inpnicht näherungsweise1.0entspricht.IllegalArgumentException- wenn nichtp[i] >= 0.0für jeden Indexigilt
-