Package pi.util

Class MathUtil

java.lang.Object
pi.util.MathUtil
public class MathUtil extends Object
Eine Sammlung von statischen Hilfsmethoden, um mathematische Berechnungen durchzuführen.
Author:
Steffen Wilke, Matthias Wilke

  • Method Summary

    Modifier and Type
    Method
    Description
    static byte
    clamp(byte value, byte min, byte max)
    Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
    static double
    clamp(double value, double min, double max)
    Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
    static float
    clamp(float value, float min, float max)
    Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
    static int
    clamp(int value, int min, int max)
    Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
    static long
    clamp(long value, long min, long max)
    Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
    static short
    clamp(short value, short min, short max)
    Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
    static boolean
    equals(double d1, double d2, double epsilon)
    Prüft, ob zwei Gleitkommazahlen innerhalb einer Toleranz gleich sind.
    static double
    getAverage(double[] numbers)
    Berechnet den Durchschnitt aller Werte im Array.
    static float
    getAverage(float[] numbers)
    Berechnet den Durchschnitt aller Werte im Array.
    static int
    getAverage(int[] numbers)
    Berechnet den Durchschnitt aller Werte im Array.
    static int
    getFullPercent(double value, double fraction)
    Berechnet den ganzzahligen Prozentwert von fraction bezogen auf value.
    static int
    getMax(int... numbers)
    Ermittelt den größten Wert aus einer Liste von Ganzzahlen.
    static double
    getPercent(double value, double fraction)
    Berechnet den Prozentwert von fraction bezogen auf value.
    static boolean
    isInt(double value)
    Prüft, ob ein double-Wert eine ganze Zahl repräsentiert.
    static boolean
    isOddNumber(int num)
    Prüft, ob eine Ganzzahl ungerade ist.
    static int
    round(double value)
    Rundet einen double-Wert auf die nächste ganze Zahl.
    static double
    round(double value, int places)
    Rundet einen double-Wert auf eine feste Anzahl von Nachkommastellen.
    static float
    round(float value, int places)
    Rundet einen float-Wert auf eine feste Anzahl von Nachkommastellen.

    Methods inherited from class java.lang.Object

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

  • Method Details

    • equals

      public static boolean equals(double d1, double d2, double epsilon)
      Prüft, ob zwei Gleitkommazahlen innerhalb einer Toleranz gleich sind.
      Parameters:
      d1 - Der erste Wert.
      d2 - Der zweite Wert.
      epsilon - Die erlaubte Abweichung.
      Returns:
      true, wenn sich beide Werte höchstens um epsilon unterscheiden, sonst false.

    • round

      public static float round(float value, int places)
      Rundet einen float-Wert auf eine feste Anzahl von Nachkommastellen.
      Parameters:
      value - Der zu rundende Wert.
      places - Die Anzahl der Nachkommastellen.
      Returns:
      Der gerundete Wert.

    • round

      public static int round(double value)
      Rundet einen double-Wert auf die nächste ganze Zahl.
      Parameters:
      value - Der zu rundende Wert.
      Returns:
      Der gerundete Wert als int.

    • round

      public static double round(double value, int places)
      Rundet einen double-Wert auf eine feste Anzahl von Nachkommastellen.
      Parameters:
      value - Der zu rundende Wert.
      places - Die Anzahl der Nachkommastellen.
      Returns:
      Der gerundete Wert.
      Throws:
      IllegalArgumentException - Wenn places kleiner als 0 ist.

    • clamp

      public static double clamp(double value, double min, double max)
      Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
      Parameters:
      value - Der zu begrenzende Wert.
      min - Der kleinste zulässige Wert.
      max - Der größte zulässige Wert.
      Returns:
      Ein auf die angegebenen Grenzen begrenzter Wert.

    • clamp

      public static float clamp(float value, float min, float max)
      Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
      Parameters:
      value - Der zu begrenzende Wert.
      min - Der kleinste zulässige Wert.
      max - Der größte zulässige Wert.
      Returns:
      Ein auf die angegebenen Grenzen begrenzter Wert.

    • clamp

      public static byte clamp(byte value, byte min, byte max)
      Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
      Parameters:
      value - Der zu begrenzende Wert.
      min - Der kleinste zulässige Wert.
      max - Der größte zulässige Wert.
      Returns:
      Ein auf die angegebenen Grenzen begrenzter Wert.

    • clamp

      public static short clamp(short value, short min, short max)
      Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
      Parameters:
      value - Der zu begrenzende Wert.
      min - Der kleinste zulässige Wert.
      max - Der größte zulässige Wert.
      Returns:
      Ein auf die angegebenen Grenzen begrenzter Wert.

    • clamp

      public static int clamp(int value, int min, int max)
      Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
      Parameters:
      value - Der zu begrenzende Wert.
      min - Der kleinste zulässige Wert.
      max - Der größte zulässige Wert.
      Returns:
      Ein auf die angegebenen Grenzen begrenzter Wert.

    • clamp

      public static long clamp(long value, long min, long max)
      Begrenzt den Wert (falls nötig) auf den Bereich zwischen Minimum und Maximum.
      Parameters:
      value - Der zu begrenzende Wert.
      min - Der kleinste zulässige Wert.
      max - Der größte zulässige Wert.
      Returns:
      Ein auf die angegebenen Grenzen begrenzter Wert.

    • getAverage

      public static double getAverage(double[] numbers)
      Berechnet den Durchschnitt aller Werte im Array.
      Parameters:
      numbers - Die Werte, aus denen der Durchschnitt berechnet wird.
      Returns:
      Der Durchschnitt der Werte.

    • getAverage

      public static float getAverage(float[] numbers)
      Berechnet den Durchschnitt aller Werte im Array.
      Parameters:
      numbers - Die Werte, aus denen der Durchschnitt berechnet wird.
      Returns:
      Der Durchschnitt der Werte.

    • getAverage

      public static int getAverage(int[] numbers)
      Berechnet den Durchschnitt aller Werte im Array.
      Parameters:
      numbers - Die Werte, aus denen der Durchschnitt berechnet wird.
      Returns:
      Der Durchschnitt der Werte.

    • getMax

      public static int getMax(int... numbers)
      Ermittelt den größten Wert aus einer Liste von Ganzzahlen.
      Parameters:
      numbers - Die zu vergleichenden Werte.
      Returns:
      Der größte gefundene Wert.

    • isInt

      public static boolean isInt(double value)
      Prüft, ob ein double-Wert eine ganze Zahl repräsentiert.
      Parameters:
      value - Der zu prüfende Wert.
      Returns:
      true, wenn der Wert eine ganze Zahl ist und nicht unendlich, sonst false.

    • isOddNumber

      public static boolean isOddNumber(int num)
      Prüft, ob eine Ganzzahl ungerade ist.
      Parameters:
      num - Die zu prüfende Zahl.
      Returns:
      true, wenn die Zahl ungerade ist, sonst false.

    • getFullPercent

      public static int getFullPercent(double value, double fraction)
      Berechnet den ganzzahligen Prozentwert von fraction bezogen auf value.
      Parameters:
      value - Der Gesamtwert.
      fraction - Der Teilwert.
      Returns:
      Der Prozentwert als ganze Zahl.

    • getPercent

      public static double getPercent(double value, double fraction)
      Berechnet den Prozentwert von fraction bezogen auf value.
      Parameters:
      value - Der Gesamtwert.
      fraction - Der Teilwert.
      Returns:
      Der Prozentwert.