org.spaceroots.mantissa.algebra

Class PolynomialFraction

java.lang.Object

org.spaceroots.mantissa.algebra.PolynomialFraction

All Implemented Interfaces:

java.io.Serializable

public class PolynomialFraction
extends java.lang.Object
implements java.io.Serializable

This class implements fractions of polynomials with one unknown and rational coefficients.

Instances of this class are immutable.

Version:

$Id: PolynomialFraction.java 1711 2006-12-13 21:27:51Z luc $

Author:

L. Maisonobe

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
PolynomialFraction() Simple constructor.
PolynomialFraction(java.math.BigInteger i) Simple constructor.
PolynomialFraction(java.math.BigInteger numerator, java.math.BigInteger denominator) Simple constructor.
PolynomialFraction(long l) Simple constructor.
PolynomialFraction(long numerator, long denominator) Simple constructor.
PolynomialFraction(Polynomial.Rational p) Simple constructor.
PolynomialFraction(Polynomial.Rational numerator, Polynomial.Rational denominator) Simple constructor.
PolynomialFraction(RationalNumber r) Simple constructor.
PolynomialFraction(RationalNumber numerator, RationalNumber denominator) Simple constructor.

Method Summary

Modifier and Type	Method and Description
PolynomialFraction	add(PolynomialFraction f) Add a polynomial fraction to the instance.
PolynomialFraction	divide(PolynomialFraction f) Divide the instance by a polynomial fraction.
Polynomial.Rational	getDenominator() Get the denominator.
Polynomial.Rational	getNumerator() Get the numerator.
PolynomialFraction	invert() Invert the instance.
PolynomialFraction	multiply(PolynomialFraction f) Multiply the instance by a polynomial fraction.
PolynomialFraction	negate() Negate the instance.
PolynomialFraction	subtract(PolynomialFraction f) Subtract a fraction from the instance.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

PolynomialFraction

public PolynomialFraction()

Simple constructor. Build a constant null fraction

PolynomialFraction

public PolynomialFraction(long numerator,
                          long denominator)

Simple constructor. Build a fraction from a numerator and a denominator.

Parameters:

numerator - numerator of the fraction

denominator - denominator of the fraction

Throws:

java.lang.ArithmeticException - if the denominator is null

PolynomialFraction

public PolynomialFraction(java.math.BigInteger numerator,
                          java.math.BigInteger denominator)

Simple constructor. Build a fraction from a numerator and a denominator.

Parameters:

numerator - numerator of the fraction

denominator - denominator of the fraction

Throws:

java.lang.ArithmeticException - if the denominator is null

PolynomialFraction

public PolynomialFraction(RationalNumber numerator,
                          RationalNumber denominator)

Simple constructor. Build a fraction from a numerator and a denominator.

Parameters:

numerator - numerator of the fraction

denominator - denominator of the fraction

Throws:

java.lang.ArithmeticException - if the denominator is null

PolynomialFraction

public PolynomialFraction(Polynomial.Rational numerator,
                          Polynomial.Rational denominator)

Simple constructor. Build a fraction from a numerator and a denominator.

Parameters:

numerator - numerator of the fraction

denominator - denominator of the fraction

Throws:

java.lang.ArithmeticException - if the denominator is null

PolynomialFraction

public PolynomialFraction(long l)

Simple constructor. Build a fraction from a single integer

Parameters:

l - value of the fraction

PolynomialFraction

public PolynomialFraction(java.math.BigInteger i)

Simple constructor. Build a fraction from a single integer

Parameters:

i - value of the fraction

PolynomialFraction

public PolynomialFraction(RationalNumber r)

Simple constructor. Build a fraction from a single rational number

Parameters:

r - value of the fraction

PolynomialFraction

public PolynomialFraction(Polynomial.Rational p)

Simple constructor. Build a fraction from a single Polynomial

Parameters:

p - value of the fraction

Method Detail

negate

public PolynomialFraction negate()

Negate the instance.

Returns:

a new polynomial fraction opposite to the instance

add

public PolynomialFraction add(PolynomialFraction f)

Add a polynomial fraction to the instance.

Parameters:

f - polynomial fraction to add.

Returns:

a new polynomial fraction

subtract

public PolynomialFraction subtract(PolynomialFraction f)

Subtract a fraction from the instance.

Parameters:

f - polynomial fraction to subtract.

Returns:

a new polynomial fraction

multiply

public PolynomialFraction multiply(PolynomialFraction f)

Multiply the instance by a polynomial fraction.

Parameters:

f - polynomial fraction to multiply by

Returns:

a new polynomial fraction

divide

public PolynomialFraction divide(PolynomialFraction f)

Divide the instance by a polynomial fraction.

Parameters:

f - polynomial fraction to divide by

Returns:

a new polynomial fraction

Throws:

java.lang.ArithmeticException - if f is null

invert

public PolynomialFraction invert()

Invert the instance.

Returns:

the inverse of the instance

Throws:

java.lang.ArithmeticException - if the instance is zero

getNumerator

public Polynomial.Rational getNumerator()

Get the numerator.

Returns:

the numerator

getDenominator

public Polynomial.Rational getDenominator()

Get the denominator.

Returns:

the denominator (leeding coefficient is always positive)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object