com.dautelle.math.functions
Class RationalFunction

java.lang.Object
  com.dautelle.realtime.RealtimeObject
      com.dautelle.math.functions.Function
          com.dautelle.math.functions.RationalFunction

All Implemented Interfaces:

Operable, Realtime, java.io.Serializable

public class RationalFunction

extends Function

This class represents the quotient of two Polynomial.

Version:

6.1, June 24, 2004

Author:

Jean-Marie Dautelle

See Also:

Rational Function -- from MathWorld, Serialized Form

Nested Class Summary

Nested classes inherited from class com.dautelle.math.functions.Function

Function.Variable

Nested classes inherited from class com.dautelle.realtime.RealtimeObject

RealtimeObject.Factory

Method Summary

java.lang.StringBuffer	appendTo(java.lang.StringBuffer sb) Appends the text representation of this function to the StringBuffer argument.
Function	compose(Function f) Returns the composition of this function with the one specified.
Function	differentiate(Function.Variable v) Returns the first derivative of this function with respect to the specified variable.
boolean	equals(java.lang.Object obj) Compares this rational function against the specified object.
Operable	evaluate() Evaluates this function by replacing its variables by their current (context-local) values.
java.lang.Object	export() Exports this object out of the current pool context.
Polynomial	getDividend() Returns the dividend of this rational function.
Polynomial	getDivisor() Returns the divisor of this rational function.
java.util.Set	getVariables() Returns a set containing this function variables.
int	hashCode() Returns the hash code for this rational function.
Operable	opposite() Returns the additive inverse of this object.
Operable	plus(Operable o) Returns the sum of this object with the one specified.
Operable	reciprocal() Returns the multiplicative inverse of this object.
Operable	times(Operable o) Returns the product of this object with the one specified.
java.lang.Object	toHeap() Moves this object to the heap.
static RationalFunction	valueOf(Polynomial dividend, Polynomial divisor) Returns the rational function from the specified dividend and divisor.

Methods inherited from class com.dautelle.math.functions.Function

integrate, pow, toString

Methods inherited from class com.dautelle.realtime.RealtimeObject

clone, isLocalObject, isPoolObject, recycle

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getDividend

public Polynomial getDividend()

Returns the dividend of this rational function.

Returns:

this rational function's dividend.

getDivisor

public Polynomial getDivisor()

Returns the divisor of this rational function.

Returns:

this rational function's divisor.

valueOf

public static RationalFunction valueOf(Polynomial dividend,
                                       Polynomial divisor)

Returns the rational function from the specified dividend and divisor.

Parameters:

dividend - the dividend value.

divisor - the divisor value.

Returns:

dividend / divisor

equals

public boolean equals(java.lang.Object obj)

Compares this rational function against the specified object.

Parameters:

obj - the object to compare with.

Returns:

true if the objects are the same; false otherwise.

hashCode

public int hashCode()

Returns the hash code for this rational function.

Returns:

the hash code value.

getVariables

public java.util.Set getVariables()

Description copied from class: Function

Returns a set containing this function variables.

Specified by:

getVariables in class Function

Returns:

the variables for this function.

evaluate

public Operable evaluate()

Description copied from class: Function

Evaluates this function by replacing its variables by their current (context-local) values.

Specified by:

evaluate in class Function

Returns:

the evaluation of this function.

appendTo

public java.lang.StringBuffer appendTo(java.lang.StringBuffer sb)

Description copied from class: Function

Appends the text representation of this function to the StringBuffer argument.

Overrides:

appendTo in class Function

Parameters:

sb - the StringBuffer to append.

Returns:

sb

export

public java.lang.Object export()

Description copied from interface: Realtime

Exports this object out of the current pool context. Realtime members are exported as well (recursion). This method affects only objects belonging to the current pool context. To avoid pool depletion, a "free" object from the outer pool is moved to replace the object being exported.

Specified by:

export in interface Realtime

Overrides:

export in class RealtimeObject

toHeap

public java.lang.Object toHeap()

Description copied from interface: Realtime

Moves this object to the heap. Realtime members are moved to the heap as well (recursion). This method affects only objects belonging to a pool context (current or not).

Specified by:

toHeap in interface Realtime

Overrides:

toHeap in class RealtimeObject

plus

public Operable plus(Operable o)

Description copied from interface: Operable

Returns the sum of this object with the one specified.

Specified by:

plus in interface Operable

Overrides:

plus in class Function

opposite

public Operable opposite()

Description copied from interface: Operable

Returns the additive inverse of this object. It is the object such as this.plus(this.opposite()) == ZERO, with ZERO being the additive identity.

Specified by:

opposite in interface Operable

Overrides:

opposite in class Function

times

public Operable times(Operable o)

Description copied from interface: Operable

Returns the product of this object with the one specified.

Specified by:

times in interface Operable

Overrides:

times in class Function

reciprocal

public Operable reciprocal()

Description copied from interface: Operable

Returns the multiplicative inverse of this object. It it the object such as this.times(this.reciprocal()) == ONE , with ONE being the multiplicative identity.

Specified by:

reciprocal in interface Operable

Overrides:

reciprocal in class Function

compose

public Function compose(Function f)

Description copied from class: Function

Returns the composition of this function with the one specified.

Overrides:

compose in class Function

Parameters:

f - the function for which the return value is passed as argument to this function.

Returns:

the function (this o that)

differentiate

public Function differentiate(Function.Variable v)

Description copied from class: Function

Returns the first derivative of this function with respect to the specified variable.

Overrides:

differentiate in class Function

Parameters:

v - the variable for which the derivative is calculated.

Returns:

d[this]/dv

See Also:

Derivative -- from MathWorld