Package edu.jas.poly
Class Residue<C extends RingElem<C>>
- java.lang.Object
-
- edu.jas.poly.Residue<C>
-
- All Implemented Interfaces:
AbelianGroupElem<Residue<C>>
,Element<Residue<C>>
,MonoidElem<Residue<C>>
,RingElem<Residue<C>>
,java.io.Serializable
,java.lang.Comparable<Residue<C>>
public class Residue<C extends RingElem<C>> extends java.lang.Object implements RingElem<Residue<C>>
Residue element based on RingElem residue. Objects of this class are (nearly) immutable.- Author:
- Heinz Kredel
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description Residue(ResidueRing<C> r)
The constructor creates a Residue object from a ring factory.Residue(ResidueRing<C> r, C a)
The constructor creates a Residue object from a ring factory and a ring element.Residue(ResidueRing<C> r, C a, int u)
The constructor creates a Residue object from a ring factory, a ring element and an indicator if a is a unit.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Residue<C>
abs()
Residue absolute value.int
compareTo(Residue<C> b)
Residue comparison.Residue<C>
copy()
Copy this.Residue<C>
divide(Residue<C> S)
Residue division.Residue<C>[]
egcd(Residue<C> b)
Extended greatest common divisor.boolean
equals(java.lang.Object b)
Comparison with any other object.ResidueRing<C>
factory()
Get the corresponding element factory.Residue<C>
gcd(Residue<C> b)
Greatest common divisor.int
hashCode()
Hash code for this local.Residue<C>
inverse()
Residue inverse.boolean
isONE()
Is Residue one.boolean
isUnit()
Is Residue unit.boolean
isZERO()
Is Residue zero.Residue<C>
multiply(Residue<C> S)
Residue multiplication.Residue<C>
negate()
Residue negate.Residue<C>[]
quotientRemainder(Residue<C> S)
Quotient and remainder by division of this by S.Residue<C>
remainder(Residue<C> S)
Residue remainder.int
signum()
Residue signum.Residue<C>
subtract(Residue<C> S)
Residue subtraction.Residue<C>
sum(Residue<C> S)
Residue summation.java.lang.String
toScript()
Get a scripting compatible string representation.java.lang.String
toScriptFactory()
Get a scripting compatible string representation of the factory.java.lang.String
toString()
Get the String representation as RingElem.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface edu.jas.structure.MonoidElem
leftDivide, leftRemainder, power, rightDivide, rightRemainder, twosidedDivide, twosidedRemainder
-
-
-
-
Constructor Detail
-
Residue
public Residue(ResidueRing<C> r)
The constructor creates a Residue object from a ring factory.- Parameters:
r
- ring factory.
-
Residue
public Residue(ResidueRing<C> r, C a)
The constructor creates a Residue object from a ring factory and a ring element.- Parameters:
r
- ring factory.a
- ring element.
-
Residue
public Residue(ResidueRing<C> r, C a, int u)
The constructor creates a Residue object from a ring factory, a ring element and an indicator if a is a unit.- Parameters:
r
- ring factory.a
- ring element.u
- isunit indicator, -1, 0, 1.
-
-
Method Detail
-
factory
public ResidueRing<C> factory()
Get the corresponding element factory.
-
isZERO
public boolean isZERO()
Is Residue zero.- Specified by:
isZERO
in interfaceAbelianGroupElem<C extends RingElem<C>>
- Returns:
- If this is 0 then true is returned, else false.
- See Also:
AbelianGroupElem.isZERO()
-
isONE
public boolean isONE()
Is Residue one.- Specified by:
isONE
in interfaceMonoidElem<C extends RingElem<C>>
- Returns:
- If this is 1 then true is returned, else false.
- See Also:
MonoidElem.isONE()
-
isUnit
public boolean isUnit()
Is Residue unit.- Specified by:
isUnit
in interfaceMonoidElem<C extends RingElem<C>>
- Returns:
- If this is a unit then true is returned, else false.
- See Also:
MonoidElem.isUnit()
-
toString
public java.lang.String toString()
Get the String representation as RingElem.- Overrides:
toString
in classjava.lang.Object
- See Also:
Object.toString()
-
toScript
public java.lang.String toScript()
Get a scripting compatible string representation.
-
toScriptFactory
public java.lang.String toScriptFactory()
Get a scripting compatible string representation of the factory.- Specified by:
toScriptFactory
in interfaceElement<C extends RingElem<C>>
- Returns:
- script compatible representation for this ElemFactory.
- See Also:
Element.toScriptFactory()
-
equals
public boolean equals(java.lang.Object b)
Comparison with any other object.
-
hashCode
public int hashCode()
Hash code for this local.
-
abs
public Residue<C> abs()
Residue absolute value.- Specified by:
abs
in interfaceAbelianGroupElem<C extends RingElem<C>>
- Returns:
- the absolute value of this.
- See Also:
AbelianGroupElem.abs()
-
sum
public Residue<C> sum(Residue<C> S)
Residue summation.- Specified by:
sum
in interfaceAbelianGroupElem<C extends RingElem<C>>
- Parameters:
S
- Residue.- Returns:
- this+S.
-
negate
public Residue<C> negate()
Residue negate.- Specified by:
negate
in interfaceAbelianGroupElem<C extends RingElem<C>>
- Returns:
- -this.
- See Also:
AbelianGroupElem.negate()
-
signum
public int signum()
Residue signum.- Specified by:
signum
in interfaceAbelianGroupElem<C extends RingElem<C>>
- Returns:
- signum(this).
- See Also:
AbelianGroupElem.signum()
-
subtract
public Residue<C> subtract(Residue<C> S)
Residue subtraction.- Specified by:
subtract
in interfaceAbelianGroupElem<C extends RingElem<C>>
- Parameters:
S
- Residue.- Returns:
- this-S.
-
divide
public Residue<C> divide(Residue<C> S)
Residue division.- Specified by:
divide
in interfaceMonoidElem<C extends RingElem<C>>
- Parameters:
S
- Residue.- Returns:
- this/S.
-
inverse
public Residue<C> inverse()
Residue inverse.- Specified by:
inverse
in interfaceMonoidElem<C extends RingElem<C>>
- Returns:
- S with S = 1/this if defined.
- See Also:
MonoidElem.inverse()
-
remainder
public Residue<C> remainder(Residue<C> S)
Residue remainder.- Specified by:
remainder
in interfaceMonoidElem<C extends RingElem<C>>
- Parameters:
S
- Residue.- Returns:
- this - (this/S)*S.
-
quotientRemainder
public Residue<C>[] quotientRemainder(Residue<C> S)
Quotient and remainder by division of this by S.- Specified by:
quotientRemainder
in interfaceMonoidElem<C extends RingElem<C>>
- Parameters:
S
- a Residue- Returns:
- [this/S, this - (this/S)*S].
-
multiply
public Residue<C> multiply(Residue<C> S)
Residue multiplication.- Specified by:
multiply
in interfaceMonoidElem<C extends RingElem<C>>
- Parameters:
S
- Residue.- Returns:
- this*S.
-
gcd
public Residue<C> gcd(Residue<C> b)
Greatest common divisor. Note: Not implemented, throws UnsupportedOperationException.
-
-