HUMath.Numerik
Class Big

java.lang.Object
  HUMath.Numerik.Big

public class Big
extends java.lang.Object

In der Klasse Big sind Funktionen mit Argumenten aus der BigDecimal Klasse zusammengefasst.

Version:

04.02.2005 00:37 / 10.5.13 Dank an Evgueni Kivman

Author:

R. Lamour/C. Guhlke/ H. Mellmann :)

Field Summary

static java.math.BigDecimal

PI

Constructor Summary

Big()

Method Summary

static java.math.BigDecimal	cos(java.math.BigDecimal x) Die Methode cos Berechnet cos( x ) mit Hilfe der Taylor-Formel, und gibt das Ergebnis mit gleicher Skallierung zurück.
static java.math.BigDecimal	cos(java.math.BigDecimal x, int scale) Die Methode cos Berechnet cos( x ), mit Hilfe der Taylor-Formel.
static java.math.BigDecimal	exp(java.math.BigDecimal s) Die Methode exp berechnet den Wert der Exponentialfunktion exp(s) mit der gleichen Stellenzahl wie s.
static java.math.BigDecimal	log(java.math.BigDecimal s) Die Methode log berechnet den Wert der Logarithmusfunktion ln(s).
static java.math.BigDecimal	PI(int scale) Die Methode PI Berechnet pi mit Hilfe der modifizierten Leibniz-Reihe; Die angegebene Skalierung kann als Anzahl der Nachkommastellen interpretiert werden, dabei sind nur Werte >= 0 möglich; Gerundet wird mit BigDecimal.ROUND_HALF_UP.
static java.math.BigDecimal	pow(java.math.BigDecimal x, int n) Die Methode pow Berechnet x^n, mit der maximalen Genauigkeit.
static java.math.BigDecimal	pow(java.math.BigDecimal x, int n, int scale) Die Methode pow Berechnet x^n, mit der maximalen Genauigkeit.
static java.math.BigDecimal	round(java.math.BigDecimal s, int mantissenlaenge) Die Methode round reduziert die Mantissenlänge der BigDezimal-Zahl auf die angegebene Länge
static java.math.BigDecimal	sin(java.math.BigDecimal x) Die Methode sin Berechnet sin( x ) mit Hilfe der Taylor-Formel, und gibt das Ergebnis mit gleicher Skalierung zurück.
static java.math.BigDecimal	sin(java.math.BigDecimal x, int scale) Die Methode sin Berechnet sin( x ), mit Hilfe der Taylor-Formel.
static java.math.BigDecimal	sqrt(java.math.BigDecimal s) Die Methode sqrt berechnet die Quadratwurzel einer BigDecimal-Zahl und gibt das Ergebnis mit gleicher Genauigkeit zurück.

Methods inherited from class java.lang.Object

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

Field Detail

PI

public static java.math.BigDecimal PI

Constructor Detail

Big

public Big()

Method Detail

sqrt

public static java.math.BigDecimal sqrt(java.math.BigDecimal s)

Die Methode sqrt berechnet die Quadratwurzel einer BigDecimal-Zahl und gibt das Ergebnis mit gleicher Genauigkeit zurück.
Negative Zahlen erzeugen IllegalArgumentException..

Parameters:

s - Radikant der Wurzel

Returns:

Positive Quadratwurzel aus dem Radikanten mit gleicher Skalierung

Throws:

java.lang.IllegalArgumentException

exp

public static java.math.BigDecimal exp(java.math.BigDecimal s)

Die Methode exp berechnet den Wert der Exponentialfunktion exp(s) mit der gleichen Stellenzahl wie s.
Ist s > 0 wird exp(s) über die Reihenentwicklung berechnet.
Ist s < 0 wird exp(-s) berechnet und der Kehrwert zurückgegeben.

log

public static java.math.BigDecimal log(java.math.BigDecimal s)

Die Methode log berechnet den Wert der Logarithmusfunktion ln(s).
Ist s > 1 wird log(s) als Nullstelle von f(x)= exp(x)-s mit dem Newtonverfahren berechnet.
Ist 0 < s < 1 wird log(s) als Nullstelle von f(x)= exp(x)-1/s berechnet und -x zurückgegeben.
Ist s <= 0 erzeugt IllegalArgumentException.
Der Anfangswert für das Newtonverfahren ist Math.log(s).

round

public static java.math.BigDecimal round(java.math.BigDecimal s,
                                         int mantissenlaenge)

Die Methode round reduziert die Mantissenlänge der BigDezimal-Zahl auf die angegebene Länge

Parameters:

s - zu bearbeitende BigDezimal-Zahl

mantissenlaenge - Mantissenlänge

Returns:

BigDezimal-Zahl mit angepasster Mantissenlänge

sin

public static java.math.BigDecimal sin(java.math.BigDecimal x)

Die Methode sin Berechnet sin( x ) mit Hilfe der Taylor-Formel, und gibt das Ergebnis mit gleicher Skalierung zurück.
Achtung: die Skalierung hat einen direkten Einfluss auf die Genauigkeit der Berechnung. Positive Skallierung kann als Anzahl der zugelassenen Nachkommastellen interpretiert werden.

Parameters:

x - das Argument von dem sin berechnet werden soll :)

Returns:

sin( x ) implements BigDecimal-Format

See Also:

sin(BigDecimal x, int scale)

sin

public static java.math.BigDecimal sin(java.math.BigDecimal x,
                                       int scale)
                                throws java.lang.IllegalArgumentException

Die Methode sin Berechnet sin( x ), mit Hilfe der Taylor-Formel. Das Ergebniss hat die Skallierung scale.
Gerundet wird mit BigDecimal.ROUND_HALF_UP.
Achtung: die Skallierung hat einen direkten Einfluss auf die Genauigkeit der Berechnung. Positive Skallierung kann als Anzahl der zugelassenen Nachkommastellen interpretiert werden.

Parameters:

x - das Argument von dem sin berechnet werden soll :)

scale - Skallierung (Genauigkeit)

Returns:

sin( x ) implements BigDecimal-Format

Throws:

java.lang.IllegalArgumentException

See Also:

sin(BigDecimal x)

cos

public static java.math.BigDecimal cos(java.math.BigDecimal x)

Die Methode cos Berechnet cos( x ) mit Hilfe der Taylor-Formel, und gibt das Ergebnis mit gleicher Skallierung zurück.
Achtung: die Skalierung hat einen direkten Einfluss auf die Genauigkeit der Berechnung. Positive Skalierung kann als Anzahl der zugelassenen Nachkommastellen interpretiert werden.

Parameters:

x - das Argument von dem sin berechnet werden soll :)

Returns:

cos( x ) implements BigDecimal-Format

See Also:

cos(BigDecimal x, int scale)

cos

public static java.math.BigDecimal cos(java.math.BigDecimal x,
                                       int scale)
                                throws java.lang.IllegalArgumentException

Die Methode cos Berechnet cos( x ), mit Hilfe der Taylor-Formel. Das Ergebniss hat die Skallierung scale.
Gerundet wird mit BigDecimal.ROUND_HALF_UP.
Achtung: die Skalierung hat einen direkten Einfluss auf die Genauigkeit der Berechnung. Positive Skalierung kann als Anzahl der zugelassenen Nachkommastellen interpretiert werden.

Parameters:

x - das Argument von dem sin berechnet werden soll :)

scale - Skalierung (Genauigkeit)

Returns:

cos( x ) implements BigDecimal-Format

Throws:

java.lang.IllegalArgumentException

See Also:

cos(BigDecimal x)

pow

public static java.math.BigDecimal pow(java.math.BigDecimal x,
                                       int n,
                                       int scale)
                                throws java.lang.IllegalArgumentException

Die Methode pow Berechnet x^n, mit der maximalen Genauigkeit. Das Ergebniss hat die Skalierung scale.
pow(x, 0 ) liefert ONE und pow(ZERO, 0 ) ist nicht definiert. Gerundet wird mit BigDecimal.ROUND_HALF_UP.
Achtung: die Skalierung hat einen direkten Einfluss auf die Genauigkeit der Berechnung. Positive Skalierung kann als Anzahl der zugelassenen Nachkommastellen interpretiert werden.

Parameters:

x - das Argument von dem pow berechnet werden soll :)

n - der Exponent

scale - Mantissenlänge (Genauigkeit)

Returns:

x^n implements BigDecimal-Format

Throws:

java.lang.IllegalArgumentException

See Also:

pow(BigDecimal x, int n)

pow

public static java.math.BigDecimal pow(java.math.BigDecimal x,
                                       int n)

Die Methode pow Berechnet x^n, mit der maximalen Genauigkeit.
n muss dabei groesser oder gleich 0 sein.
pow(x, 0 ) liefert ONE und pow(ZERO, 0 ) ist nicht definiert.

Parameters:

x - das Argument von dem pow berechnet werden soll :)

n - der Exponent

Returns:

x^n implements BigDecimal-Format

See Also:

pow(BigDecimal x, int n, int mantissenlaenge)

PI

public static java.math.BigDecimal PI(int scale)
                               throws java.lang.IllegalArgumentException

Die Methode PI Berechnet pi mit Hilfe der modifizierten Leibniz-Reihe;
Die angegebene Skalierung kann als Anzahl der Nachkommastellen interpretiert werden, dabei sind nur Werte >= 0 möglich;
Gerundet wird mit BigDecimal.ROUND_HALF_UP.

Parameters:

scale - Anzahl der Nachkommastellen der Zahl PI;

Returns:

pi implements BigDecimal-Format

Throws:

java.lang.IllegalArgumentException