Klasse StdStats
Grenzen:
- Ungültige Voraussetzungen: Alle hier implementierten Methoden werfen Ausnahmen, wenn ihre Parameterbelegungen ungültige Voraussetzungen für ihre Anwendung darstellen.
- Numerische Grenzen: Es werden keine komplexen Algorithmen verwendet, welche die numerischen Grenzen von Java versuchen, zu verbergen oder auszugleichen. Es gelten die numerischen Grenzen des Java-Standards.
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-19)
- Autor:
- Karsten Brodmann (karsten.brodmann@osnanet.de)
-
Methodenübersicht
Modifikator und TypMethodeBeschreibungstatic doubleiqr(double[] a) Berechnung des Interquartilsabstands in Arraya[].static doubleiqr(int[] a) Berechnung des Interquartilsabstands in Arraya[].static doublemax(double[] a) Maximum der Werte aus Arraya[].static intmax(int[] a) Maximum der Werte aus Arraya[].static doublemean(double[] a) Mittelwert der Werte von Arraya[]berechnen.static doublemean(int[] a) Mittelwert der Werte von Arraya[]berechnen.static doublemedian(double[] a) Median des Arraysa[].static doublemedian(int[] a) Median des Arraysa[].static doublemin(double[] a) Minimum der Werte aus Arraya[].static intmin(int[] a) Minimum der Werte aus Arraya[].static double[]mode(double[] a) Modalwert der Werte in Arraya[].static int[]mode(int[] a) Modalwert der Werte in Arraya[].static doublequantile(double[] a, double quantile) Berechnung eines Quantils der Werte in Arraya[].static doublequantile(int[] a, double quantile) Berechnung eines Quantils der Werte in Arraya[].static doubleskewnessPopulation(double[] a) Schiefe der Grundgesamtheit.static doubleskewnessPopulation(int[] a) Schiefe der Grundgesamtheit.static doubleskewnessSample(double[] a) Schiefe der Stichprobe.static doubleskewnessSample(int[] a) Schiefe der Stichprobe.static doublestdDevPopulation(double[] a) Standardabweichung in der Grundgesamtheit.static doublestdDevPopulation(int[] a) Standardabweichung in der Grundgesamtheit.static doublestdDevSample(double[] a) Standardabweichung in der Stichprobe.static doublestdDevSample(int[] a) Standardabweichung in der Stichprobe.static doublesum(double[] a) Summe der Werte in Arraya[].static doublesum(int[] a) Summe der Werte in Arraya[].static doublevarPopulation(double[] a) Varianz der Grundgesamtheit.static doublevarPopulation(int[] a) Varianz der Grundgesamtheit.static doublevarSample(double[] a) Varianz der Stichprobe.static doublevarSample(int[] a) Varianz der Stichprobe.
-
Methodendetails
-
max
public static int max(int[] a) Maximum der Werte aus Arraya[].- Parameter:
a- Array- Gibt zurück:
- Maximum von
a
-
max
public static double max(double[] a) Maximum der Werte aus Arraya[].- Parameter:
a- Array- Gibt zurück:
- Maximum von
a
-
min
public static int min(int[] a) Minimum der Werte aus Arraya[].- Parameter:
a- Array- Gibt zurück:
- Minimum von
a
-
min
public static double min(double[] a) Minimum der Werte aus Arraya[].- Parameter:
a- Array- Gibt zurück:
- Minimum von
a
-
sum
public static double sum(int[] a) Summe der Werte in Arraya[]. Zur Vermeidung eines Integer-Overflows wird die Summe auf den Datentypdoubleabgebildet.Ganze Zahlen sind in double nur bis \(2^{53}\) lückenlos darstellbar. Darüber können bei der Summation Rundungsfehler auftreten. Um diese weitestgehend zu vermeiden, wird das Verfahren der Neumaier-Summation angewendet.
- Parameter:
a- Array- Gibt zurück:
- Summe
-
sum
public static double sum(double[] a) Summe der Werte in Arraya[].Ganze Zahlen sind in double nur bis \(2^{53}\) lückenlos darstellbar. Darüber können bei der Summation Rundungsfehler auftreten. Um diese weitestgehend zu vermeiden, wird das Verfahren der Neumaier-Summation angewendet. Hierbei ergibt sich für
double[] a = {1e16, 1.0, -1e16};die Summe1.0statt0.0, wie es bei einer einfachen Summenbildung der Fall wäre.- Parameter:
a- Array- Gibt zurück:
- Summe
-
mean
public static double mean(int[] a) Mittelwert der Werte von Arraya[]berechnen.Hinweis:
Liegt die mathematische Summe der Werte außerhalb des darstellbaren Wertebereichs von
double, ist das Ergebnis unendlich.- Parameter:
a- Array- Gibt zurück:
- Mittelwert
-
mean
public static double mean(double[] a) Mittelwert der Werte von Arraya[]berechnen.Hinweis:
Liegt die mathematische Summe der Werte außerhalb des darstellbaren Wertebereichs von
double, ist das Ergebnis unendlich. Beispiel:double[] a = {1e308, 1e308};überschreitet den Wertebereich vondoublebeim summieren. Das führt zu einem unendlichen Ergebnis, obgleich der Mittelwert1e308ist.- Parameter:
a- Array- Gibt zurück:
- Mittelwert
-
median
public static double median(int[] a) Median des Arraysa[].Bei einem Array
double[] a = {1e308, 1e308};wird der Wertebereich vondoublebei der Summenbildung überschritte. Statt des eigentlich korrekten Werts von1e308liefert die Methode unendlich.- Parameter:
a- Array- Gibt zurück:
- Median
-
median
public static double median(double[] a) Median des Arraysa[].- Parameter:
a- Array- Gibt zurück:
- Median
-
varPopulation
public static double varPopulation(int[] a) Varianz der Grundgesamtheit.- Parameter:
a- Array- Gibt zurück:
- Varianz
-
varSample
public static double varSample(int[] a) Varianz der Stichprobe.- Parameter:
a- Array- Gibt zurück:
- Varianz
-
varPopulation
public static double varPopulation(double[] a) Varianz der Grundgesamtheit.- Parameter:
a- Array- Gibt zurück:
- Varianz
-
varSample
public static double varSample(double[] a) Varianz der Stichprobe.- Parameter:
a- Array- Gibt zurück:
- Varianz
-
stdDevPopulation
public static double stdDevPopulation(int[] a) Standardabweichung in der Grundgesamtheit.- Parameter:
a- Array- Gibt zurück:
- Standardabweichung
-
stdDevSample
public static double stdDevSample(int[] a) Standardabweichung in der Stichprobe.- Parameter:
a- Array- Gibt zurück:
- Standardabweichung
-
stdDevPopulation
public static double stdDevPopulation(double[] a) Standardabweichung in der Grundgesamtheit.- Parameter:
a- Array- Gibt zurück:
- Standardabweichung
-
stdDevSample
public static double stdDevSample(double[] a) Standardabweichung in der Stichprobe.- Parameter:
a- Array- Gibt zurück:
- Standardabweichung
-
skewnessPopulation
public static double skewnessPopulation(int[] a) Schiefe der Grundgesamtheit.- Parameter:
a- Array- Gibt zurück:
- Schiefe
- Löst aus:
IllegalArgumentException- wenn Standardabweichung in den Daten gleich Null
-
skewnessPopulation
public static double skewnessPopulation(double[] a) Schiefe der Grundgesamtheit.- Parameter:
a- Array- Gibt zurück:
- Schiefe
- Löst aus:
IllegalArgumentException- wenn Standardabweichung in den Daten gleich Null
-
skewnessSample
public static double skewnessSample(int[] a) Schiefe der Stichprobe.- Parameter:
a- Array- Gibt zurück:
- Schiefe
-
skewnessSample
public static double skewnessSample(double[] a) Schiefe der Stichprobe.- Parameter:
a- Array- Gibt zurück:
- Schiefe
-
mode
public static int[] mode(int[] a) Modalwert der Werte in Arraya[].Es wird grundsätzlich ein Array der Modalwerte zurückgegeben. Das Array kann leer sein, wenn alle Werte in
adieselbe Häufigkeit besitzen.- Parameter:
a- Array- Gibt zurück:
- Modalwert
-
mode
public static double[] mode(double[] a) Modalwert der Werte in Arraya[].Es wird grundsätzlich ein Array der Modalwerte zurückgegeben. Das Array kann leer sein, wenn alle Werte in
adieselbe Häufigkeit besitzen.- Parameter:
a- Array- Gibt zurück:
- Modalwert
-
quantile
public static double quantile(double[] a, double quantile) Berechnung eines Quantils der Werte in Arraya[]. Es wird die sogenannte Typ-7-Quantildefinition nach Hyndman und Fan verwendet. Diese wird standardmäßig auch in R genutzt.- Parameter:
a- Arrayquantile- Quantil- Gibt zurück:
- Quantilswert
- Löst aus:
IllegalArgumentException- wenn Quantil nicht in \([0, 1]\)
-
quantile
public static double quantile(int[] a, double quantile) Berechnung eines Quantils der Werte in Arraya[]. Es wird die sogenannte Typ-7-Quantildefinition nach Hyndman und Fan verwendet. Diese wird standardmäßig auch in R genutzt.- Parameter:
a- Arrayquantile- Quantil- Gibt zurück:
- Quantilswert
- Löst aus:
IllegalArgumentException- wenn unendliche Werte im Array vorhanden sindIllegalArgumentException- wenn Quantil nicht in \([0, 1]\)
-
iqr
public static double iqr(int[] a) Berechnung des Interquartilsabstands in Arraya[].Die Methode nutzt die Methode
quantile(int[],double).- Parameter:
a- Array- Gibt zurück:
- Interquartilsabstand
-
iqr
public static double iqr(double[] a) Berechnung des Interquartilsabstands in Arraya[].Die Methode nutzt die Methode
quantile(double[],double).- Parameter:
a- Array- Gibt zurück:
- Interquartilsabstand
-