org.lsmp.djep.groupJep.values.FreeGroupElement Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jep Show documentation

JEP is a Java library for parsing and evaluating mathematical expressions.

The newest version!

/* @author rich
 * Created on 09-Mar-2004
 */
package org.lsmp.djep.groupJep.values;

import org.lsmp.djep.groupJep.groups.FreeGroup;
import org.nfunk.jep.type.*;

/**
 * An element of a free group with one generator.
 *
 * @see org.lsmp.djep.groupJep.groups.FreeGroup
 * @author Rich Morris
 * Created on 09-Mar-2004
 */
public class FreeGroupElement extends Polynomial implements HasComplexValueI {

	FreeGroup group;

	/**
	 * An element of a free group with one generator.
	 * @param K the free group.
	 * @param coeffs array of coefficients for this element c0 + c1 t + ... + cn t^n 
	 */
	public FreeGroupElement(FreeGroup K, Number coeffs[]) {
		super(K.getBaseRing(),K.getSymbol(),coeffs);
		this.group = K;
	}

//	public AlgebraicNumber(RingI baseRing,Polynomial poly,Number coeffs[]) {
//		this(new AlgebraicExtension(baseRing,poly),coeffs);
//	}

	/** sub classes should overwrite this to make the correct type. */
	protected Polynomial valueOf(Number lcoeffs[])
	{
		FreeGroupElement g = new FreeGroupElement(group,lcoeffs);
		return g;
	}

	/** Returns an approximation to the complex number representing this algebraic number. 
	 * This only gives meaningful results if setRootValue has been called
	 * or if it is a quadratic extension (t^2+b t+c) or if it is a simple n-th root (t^n+a).
	 * In the last two cases the root value is calculated automatically. 
	 * @return Complex(Nan) if currently unable to calculate it. */

	public Complex getComplexValue() {
			return calculateComplexValue(group.getRootVal());
	}
}