001/*
002 * $Id: FactorRealReal.java 4960 2014-10-17 18:46:22Z kredel $
003 */
004
005package edu.jas.application;
006
007
008import java.util.ArrayList;
009import java.util.List;
010
011import org.apache.log4j.Logger;
012
013import edu.jas.arith.Rational;
014import edu.jas.poly.GenPolynomial;
015import edu.jas.poly.GenPolynomialRing;
016import edu.jas.structure.GcdRingElem;
017import edu.jas.ufd.FactorAbstract;
018
019
020/**
021 * Real algebraic number coefficients factorization algorithms. This class
022 * implements factorization methods for polynomials over bi-variate real
023 * algebraic numbers from package
024 * 
025 * <pre>
026 * edu.jas.application
027 * </pre>
028 * 
029 * .
030 * @param <C> coefficient type
031 * @author Heinz Kredel
032 */
033
034public class FactorRealReal<C extends GcdRingElem<C> & Rational> extends
035                FactorAbstract<RealAlgebraicNumber<C>> {
036
037
038    // TODO: is absolute possible? and what does it mean?
039    //FactorAbsolute<AlgebraicNumber<C>>
040    //FactorAbstract<AlgebraicNumber<C>>
041
042
043    private static final Logger logger = Logger.getLogger(FactorRealReal.class);
044
045
046    private final boolean debug = logger.isInfoEnabled();
047
048
049    /**
050     * Factorization engine for base coefficients.
051     */
052    public final FactorAbstract<edu.jas.root.RealAlgebraicNumber<C>> factorAlgebraic;
053
054
055    /**
056     * No argument constructor. <b>Note:</b> can't use this constructor.
057     */
058    protected FactorRealReal() {
059        throw new IllegalArgumentException("don't use this constructor");
060    }
061
062
063    /**
064     * Constructor.
065     * @param fac algebraic number factory.
066     */
067    @SuppressWarnings("cast")
068    public FactorRealReal(RealAlgebraicRing<C> fac) {
069        // ignore recursion, as it is handled in FactorRealAlgebraic:
070        this(
071                        fac,
072                        FactorFactory.<edu.jas.root.RealAlgebraicNumber<C>> getImplementation((edu.jas.root.RealAlgebraicRing<C>) (Object) fac.realRing));
073    }
074
075
076    /**
077     * Constructor.
078     * @param fac algebraic number factory.
079     * @param factorAlgebraic factorization engine for polynomials over base
080     *            coefficients.
081     */
082    public FactorRealReal(RealAlgebraicRing<C> fac,
083                    FactorAbstract<edu.jas.root.RealAlgebraicNumber<C>> factorAlgebraic) {
084        super(fac);
085        this.factorAlgebraic = factorAlgebraic;
086    }
087
088
089    /**
090     * GenPolynomial base factorization of a squarefree polynomial.
091     * @param P squarefree GenPolynomial&lt;RealAlgebraicNumber&lt;C&gt;&gt;.
092     * @return [p_1,...,p_k] with P = prod_{i=1, ..., k} p_i.
093     */
094    @Override
095    @SuppressWarnings("cast")
096    public List<GenPolynomial<RealAlgebraicNumber<C>>> baseFactorsSquarefree(
097                    GenPolynomial<RealAlgebraicNumber<C>> P) {
098        if (P == null) {
099            throw new IllegalArgumentException(this.getClass().getName() + " P == null");
100        }
101        List<GenPolynomial<RealAlgebraicNumber<C>>> factors = new ArrayList<GenPolynomial<RealAlgebraicNumber<C>>>();
102        if (P.isZERO()) {
103            return factors;
104        }
105        if (P.isONE()) {
106            factors.add(P);
107            return factors;
108        }
109        GenPolynomialRing<RealAlgebraicNumber<C>> pfac = P.ring; // Q(alpha)[x]
110        if (pfac.nvar > 1) {
111            throw new IllegalArgumentException("only for univariate polynomials");
112        }
113        RealAlgebraicRing<C> rere = (RealAlgebraicRing<C>) pfac.coFac;
114        edu.jas.root.RealAlgebraicRing<C> rfac = (edu.jas.root.RealAlgebraicRing<C>) (Object) rere.realRing;
115
116        RealAlgebraicNumber<C> ldcf = P.leadingBaseCoefficient();
117        if (!ldcf.isONE()) {
118            P = P.monic();
119            factors.add(pfac.getONE().multiply(ldcf));
120        }
121        //System.out.println("\nP = " + P);
122        GenPolynomialRing<edu.jas.root.RealAlgebraicNumber<C>> arfac = new GenPolynomialRing<edu.jas.root.RealAlgebraicNumber<C>>(
123                        rfac, pfac);
124        GenPolynomial<edu.jas.root.RealAlgebraicNumber<C>> A = PolyUtilApp.<C> realAlgFromRealCoefficients(
125                        arfac, P);
126        // factor A:
127        List<GenPolynomial<edu.jas.root.RealAlgebraicNumber<C>>> afactors = factorAlgebraic
128                        .baseFactorsSquarefree(A);
129        for (GenPolynomial<edu.jas.root.RealAlgebraicNumber<C>> a : afactors) {
130            GenPolynomial<RealAlgebraicNumber<C>> p = PolyUtilApp.<C> realFromRealAlgCoefficients(pfac, a);
131            factors.add(p);
132        }
133        if (debug) {
134            logger.info("rafactors = " + factors);
135        }
136        return factors;
137    }
138
139}