Klasse StdStats

java.lang.Object
StdLib.StdStats

public class StdStats extends Object
Statistische Methoden zur deskriptiven Statistik.

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 Typ
    Methode
    Beschreibung
    static double
    iqr(double[] a)
    Berechnung des Interquartilsabstands in Array a[].
    static double
    iqr(int[] a)
    Berechnung des Interquartilsabstands in Array a[].
    static double
    max(double[] a)
    Maximum der Werte aus Array a[].
    static int
    max(int[] a)
    Maximum der Werte aus Array a[].
    static double
    mean(double[] a)
    Mittelwert der Werte von Array a[] berechnen.
    static double
    mean(int[] a)
    Mittelwert der Werte von Array a[] berechnen.
    static double
    median(double[] a)
    Median des Arrays a[].
    static double
    median(int[] a)
    Median des Arrays a[].
    static double
    min(double[] a)
    Minimum der Werte aus Array a[].
    static int
    min(int[] a)
    Minimum der Werte aus Array a[].
    static double[]
    mode(double[] a)
    Modalwert der Werte in Array a[].
    static int[]
    mode(int[] a)
    Modalwert der Werte in Array a[].
    static double
    quantile(double[] a, double quantile)
    Berechnung eines Quantils der Werte in Array a[].
    static double
    quantile(int[] a, double quantile)
    Berechnung eines Quantils der Werte in Array a[].
    static double
    skewnessPopulation(double[] a)
    Schiefe der Grundgesamtheit.
    static double
    Schiefe der Grundgesamtheit.
    static double
    skewnessSample(double[] a)
    Schiefe der Stichprobe.
    static double
    skewnessSample(int[] a)
    Schiefe der Stichprobe.
    static double
    stdDevPopulation(double[] a)
    Standardabweichung in der Grundgesamtheit.
    static double
    Standardabweichung in der Grundgesamtheit.
    static double
    stdDevSample(double[] a)
    Standardabweichung in der Stichprobe.
    static double
    stdDevSample(int[] a)
    Standardabweichung in der Stichprobe.
    static double
    sum(double[] a)
    Summe der Werte in Array a[].
    static double
    sum(int[] a)
    Summe der Werte in Array a[].
    static double
    varPopulation(double[] a)
    Varianz der Grundgesamtheit.
    static double
    varPopulation(int[] a)
    Varianz der Grundgesamtheit.
    static double
    varSample(double[] a)
    Varianz der Stichprobe.
    static double
    varSample(int[] a)
    Varianz der Stichprobe.

    Von Klasse geerbte Methoden Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Methodendetails

    • max

      public static int max(int[] a)
      Maximum der Werte aus Array a[].
      Parameter:
      a - Array
      Gibt zurück:
      Maximum von a
    • max

      public static double max(double[] a)
      Maximum der Werte aus Array a[].
      Parameter:
      a - Array
      Gibt zurück:
      Maximum von a
    • min

      public static int min(int[] a)
      Minimum der Werte aus Array a[].
      Parameter:
      a - Array
      Gibt zurück:
      Minimum von a
    • min

      public static double min(double[] a)
      Minimum der Werte aus Array a[].
      Parameter:
      a - Array
      Gibt zurück:
      Minimum von a
    • sum

      public static double sum(int[] a)
      Summe der Werte in Array a[]. Zur Vermeidung eines Integer-Overflows wird die Summe auf den Datentyp double abgebildet.

      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 Array a[].

      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 Summe 1.0 statt 0.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 Array a[] 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 Array a[] 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 von double beim summieren. Das führt zu einem unendlichen Ergebnis, obgleich der Mittelwert 1e308 ist.

      Parameter:
      a - Array
      Gibt zurück:
      Mittelwert
    • median

      public static double median(int[] a)
      Median des Arrays a[].

      Bei einem Array double[] a = {1e308, 1e308}; wird der Wertebereich von double bei der Summenbildung überschritte. Statt des eigentlich korrekten Werts von 1e308 liefert die Methode unendlich.

      Parameter:
      a - Array
      Gibt zurück:
      Median
    • median

      public static double median(double[] a)
      Median des Arrays a[].
      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 Array a[].

      Es wird grundsätzlich ein Array der Modalwerte zurückgegeben. Das Array kann leer sein, wenn alle Werte in a dieselbe Häufigkeit besitzen.

      Parameter:
      a - Array
      Gibt zurück:
      Modalwert
    • mode

      public static double[] mode(double[] a)
      Modalwert der Werte in Array a[].

      Es wird grundsätzlich ein Array der Modalwerte zurückgegeben. Das Array kann leer sein, wenn alle Werte in a dieselbe 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 Array a[]. Es wird die sogenannte Typ-7-Quantildefinition nach Hyndman und Fan verwendet. Diese wird standardmäßig auch in R genutzt.
      Parameter:
      a - Array
      quantile - 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 Array a[]. Es wird die sogenannte Typ-7-Quantildefinition nach Hyndman und Fan verwendet. Diese wird standardmäßig auch in R genutzt.
      Parameter:
      a - Array
      quantile - Quantil
      Gibt zurück:
      Quantilswert
      Löst aus:
      IllegalArgumentException - wenn unendliche Werte im Array vorhanden sind
      IllegalArgumentException - wenn Quantil nicht in \([0, 1]\)
    • iqr

      public static double iqr(int[] a)
      Berechnung des Interquartilsabstands in Array a[].

      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 Array a[].

      Die Methode nutzt die Methode quantile(double[],double).

      Parameter:
      a - Array
      Gibt zurück:
      Interquartilsabstand