edu.jas.poly
Class ComplexRing<C extends RingElem<C>>

java.lang.Object
  edu.jas.poly.ComplexRing<C>

Type Parameters:

C - base type.

All Implemented Interfaces:

AbelianGroupFactory<Complex<C>>, ElemFactory<Complex<C>>, MonoidFactory<Complex<C>>, RingFactory<Complex<C>>, java.io.Serializable

public class ComplexRing<C extends RingElem<C>>
extends java.lang.Object
implements RingFactory<Complex<C>>

Generic Complex ring factory implementing the RingFactory interface. Objects of this class are immutable.

Author:

Heinz Kredel

See Also:

Serialized Form

Field Summary

RingFactory<C>

ring Complex class elements factory data structure.

Constructor Summary

ComplexRing(RingFactory<C> ring)
The constructor creates a ComplexRing object.

Method Summary

java.math.BigInteger	characteristic() Characteristic of this ring.
Complex<C>	copy(Complex<C> c) Copy Complex element c.
boolean	equals(java.lang.Object b) Comparison with any other object.
Complex<C>	fromInteger(java.math.BigInteger a) Get a Complex element from a BigInteger.
Complex<C>	fromInteger(long a) Get a Complex element from a long.
java.util.List<Complex<C>>	generators() Get a list of the generating elements.
Complex<C>	getIMAG() Get the i element.
Complex<C>	getONE() Get the one element.
Complex<C>	getZERO() Get the zero element.
int	hashCode() Hash code for this ComplexRing<C>.
boolean	isAssociative() Query if this ring is associative.
boolean	isCommutative() Query if this ring is commutative.
boolean	isField() Query if this ring is a field.
boolean	isFinite() Is this structure finite or infinite.
Complex<C>	parse(java.io.Reader r) Parse complex number from Reader.
Complex<C>	parse(java.lang.String s) Parse complex number from string.
Complex<C>	random(int n) Complex number random.
Complex<C>	random(int n, java.util.Random rnd) Complex number random.
java.lang.String	toScript() Get a scripting compatible string representation.
java.lang.String	toString() Get the String representation.

Methods inherited from class java.lang.Object

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

Field Detail

ring

public final RingFactory<C extends RingElem<C>> ring

Complex class elements factory data structure.

Constructor Detail

ComplexRing

public ComplexRing(RingFactory<C> ring)

The constructor creates a ComplexRing object.

Parameters:

ring - factory for Complex real and imaginary parts.

Method Detail

generators

public java.util.List<Complex<C>> generators()

Get a list of the generating elements.

Specified by:

generators in interface ElemFactory<Complex<C extends RingElem<C>>>

Returns:

list of generators for the algebraic structure.

See Also:

ElemFactory.generators()

isFinite

public boolean isFinite()

Is this structure finite or infinite.

Specified by:

isFinite in interface ElemFactory<Complex<C extends RingElem<C>>>

Returns:

true if this structure is finite, else false.

See Also:

ElemFactory.isFinite()

copy

public Complex<C> copy(Complex<C> c)

Copy Complex element c.

Specified by:

copy in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

c - Complex<C>.

Returns:

a copy of c.

getZERO

public Complex<C> getZERO()

Get the zero element.

Specified by:

getZERO in interface AbelianGroupFactory<Complex<C extends RingElem<C>>>

Returns:

0 as Complex<C>.

getONE

public Complex<C> getONE()

Get the one element.

Specified by:

getONE in interface MonoidFactory<Complex<C extends RingElem<C>>>

Returns:

1 as Complex<C>.

getIMAG

public Complex<C> getIMAG()

Get the i element.

Returns:

i as Complex<C>.

isCommutative

public boolean isCommutative()

Query if this ring is commutative.

Specified by:

isCommutative in interface MonoidFactory<Complex<C extends RingElem<C>>>

Returns:

true.

isAssociative

public boolean isAssociative()

Query if this ring is associative.

Specified by:

isAssociative in interface MonoidFactory<Complex<C extends RingElem<C>>>

Returns:

true.

isField

public boolean isField()

Query if this ring is a field.

Specified by:

isField in interface RingFactory<Complex<C extends RingElem<C>>>

Returns:

true.

characteristic

public java.math.BigInteger characteristic()

Characteristic of this ring.

Specified by:

characteristic in interface RingFactory<Complex<C extends RingElem<C>>>

Returns:

characteristic of this ring.

fromInteger

public Complex<C> fromInteger(java.math.BigInteger a)

Get a Complex element from a BigInteger.

Specified by:

fromInteger in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

a - BigInteger.

Returns:

a Complex<C>.

fromInteger

public Complex<C> fromInteger(long a)

Get a Complex element from a long.

Specified by:

fromInteger in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

a - long.

Returns:

a Complex<C>.

toString

public java.lang.String toString()

Get the String representation.

Overrides:

toString in class java.lang.Object

toScript

public java.lang.String toScript()

Get a scripting compatible string representation.

Specified by:

toScript in interface ElemFactory<Complex<C extends RingElem<C>>>

Returns:

script compatible representation for this Element.

See Also:

Element.toScript()

equals

public boolean equals(java.lang.Object b)

Comparison with any other object.

Overrides:

equals in class java.lang.Object

See Also:

Object.equals(java.lang.Object)

hashCode

public int hashCode()

Hash code for this ComplexRing<C>.

Overrides:

hashCode in class java.lang.Object

See Also:

Object.hashCode()

random

public Complex<C> random(int n)

Complex number random. Random base numbers A and B are generated using random(n). Then R is the complex number with real part A and imaginary part B.

Specified by:

random in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

n - such that 0 ≤ A, B ≤ (2ⁿ-1).

Returns:

R.

random

public Complex<C> random(int n,
                         java.util.Random rnd)

Complex number random. Random base numbers A and B are generated using random(n). Then R is the complex number with real part A and imaginary part B.

Specified by:

random in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

n - such that 0 ≤ A, B ≤ (2ⁿ-1).

rnd - is a source for random bits.

Returns:

R.

parse

public Complex<C> parse(java.lang.String s)

Parse complex number from string.

Specified by:

parse in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

s - String.

Returns:

Complex from s.

parse

public Complex<C> parse(java.io.Reader r)

Parse complex number from Reader.

Specified by:

parse in interface ElemFactory<Complex<C extends RingElem<C>>>

Parameters:

r - Reader.

Returns:

next Complex from r.