001/*
002 * $Id: RealRootsAbstract.java 5572 2016-08-04 16:28:36Z kredel $
003 */
004
005package edu.jas.root;
006
007
008import java.util.ArrayList;
009import java.util.List;
010
011import org.apache.log4j.Logger;
012
013import edu.jas.arith.BigDecimal;
014import edu.jas.arith.BigInteger;
015import edu.jas.arith.BigRational;
016import edu.jas.arith.Rational;
017import edu.jas.poly.GenPolynomial;
018import edu.jas.poly.GenPolynomialRing;
019import edu.jas.poly.PolyUtil;
020import edu.jas.structure.RingElem;
021import edu.jas.structure.RingFactory;
022import edu.jas.structure.UnaryFunctor;
023
024
025/**
026 * Real roots abstract class.
027 * @param <C> coefficient type.
028 * @author Heinz Kredel
029 */
030public abstract class RealRootsAbstract<C extends RingElem<C> & Rational> implements RealRoots<C> {
031
032
033    private static final Logger logger = Logger.getLogger(RealRootsAbstract.class);
034
035
036    //private static final boolean debug = logger.isDebugEnabled();
037
038
039    /**
040     * Real root bound. With f(M) * f(-M) != 0.
041     * @param f univariate polynomial.
042     * @return M such that -M &lt; root(f) &lt; M.
043     */
044    public C realRootBound(GenPolynomial<C> f) {
045        if (f == null) {
046            return null;
047        }
048        RingFactory<C> cfac = f.ring.coFac;
049        C M = cfac.getONE();
050        if (f.isZERO()) {
051            return M;
052        }
053        if (f.isConstant()) {
054            M = f.leadingBaseCoefficient().abs().sum(cfac.getONE());
055            return M;
056        }
057        C a = f.leadingBaseCoefficient().abs();
058        for (C c : f.getMap().values()) {
059            C d = c.abs().divide(a);
060            if (M.compareTo(d) < 0) {
061                M = d;
062            }
063        }
064        // works also without this case, only for optimization 
065        // to use integral number interval end points
066        // could be obsolete: can fail if real root is in interval [r,r+1] 
067        // for too low precision or too big r, since r is approximation
068        /*
069        if (false&&(Object) M instanceof RealAlgebraicNumber) {
070            RealAlgebraicNumber Mr = (RealAlgebraicNumber) M;
071            BigRational r = Mr.magnitude();
072            //logger.info("rational root bound: " + r);
073            BigInteger i = new BigInteger(r.numerator().divide(r.denominator()));
074            i = i.sum(BigInteger.ONE);
075            //logger.info("integer root bound: " + i);
076            //M = cfac.fromInteger(r.numerator()).divide(cfac.fromInteger(r.denominator()));
077            M = cfac.fromInteger(i.getVal());
078            M = M.sum(f.ring.coFac.getONE());
079            logger.info("root bound: " + M);
080            //System.out.println("M = " + M);
081            return M;
082        }
083        */
084        BigRational r = M.getRational();
085        logger.info("rational root bound: " + r);
086        BigInteger i = new BigInteger(r.numerator().divide(r.denominator()));
087        i = i.sum(BigInteger.ONE); // ceiling
088        M = cfac.fromInteger(i.getVal());
089        M = M.sum(f.ring.coFac.getONE());
090        logger.info("integer root bound: " + M);
091        //System.out.println("M = " + M);
092        return M;
093    }
094
095
096    /**
097     * Magnitude bound.
098     * @param iv interval.
099     * @param f univariate polynomial.
100     * @return B such that |f(c)| &lt; B for c in iv.
101     */
102    @SuppressWarnings("cast")
103    public C magnitudeBound(Interval<C> iv, GenPolynomial<C> f) {
104        if (f == null) {
105            return null;
106        }
107        if (f.isZERO()) {
108            return f.ring.coFac.getONE();
109        }
110        if (f.isConstant()) {
111            return f.leadingBaseCoefficient().abs();
112        }
113        GenPolynomial<C> fa = f.map(new UnaryFunctor<C, C>() {
114
115
116            public C eval(C a) {
117                return a.abs();
118            }
119        });
120        //System.out.println("fa = " + fa);
121        C M = iv.left.abs();
122        if (M.compareTo(iv.right.abs()) < 0) {
123            M = iv.right.abs();
124        }
125        //System.out.println("M = " + M);
126        RingFactory<C> cfac = f.ring.coFac;
127        C B = PolyUtil.<C> evaluateMain(cfac, fa, M);
128        // works also without this case, only for optimization 
129        // to use rational number interval end points
130        // can fail if real root is in interval [r,r+1] 
131        // for too low precision or too big r, since r is approximation
132        if ((Object) B instanceof RealAlgebraicNumber) {
133            RealAlgebraicNumber Br = (RealAlgebraicNumber) B;
134            BigRational r = Br.magnitude();
135            B = cfac.fromInteger(r.numerator()).divide(cfac.fromInteger(r.denominator()));
136        }
137        //System.out.println("B = " + B);
138        return B;
139    }
140
141
142    /**
143     * Bi-section point.
144     * @param iv interval with f(left) * f(right) != 0.
145     * @param f univariate polynomial, non-zero.
146     * @return a point c in the interval iv such that f(c) != 0.
147     */
148    public C bisectionPoint(Interval<C> iv, GenPolynomial<C> f) {
149        if (f == null) {
150            return null;
151        }
152        RingFactory<C> cfac = f.ring.coFac;
153        C two = cfac.fromInteger(2);
154        C c = iv.left.sum(iv.right);
155        c = c.divide(two);
156        if (f.isZERO() || f.isConstant()) {
157            return c;
158        }
159        C m = PolyUtil.<C> evaluateMain(cfac, f, c);
160        while (m.isZERO()) {
161            C d = iv.left.sum(c);
162            d = d.divide(two);
163            if (d.equals(c)) {
164                d = iv.right.sum(c);
165                d = d.divide(two);
166                if (d.equals(c)) {
167                    throw new RuntimeException("should not happen " + iv);
168                }
169            }
170            c = d;
171            m = PolyUtil.<C> evaluateMain(cfac, f, c);
172            //System.out.println("c = " + c);
173        }
174        //System.out.println("c = " + c);
175        return c;
176    }
177
178
179    /**
180     * Isolating intervals for the real roots.
181     * @param f univariate polynomial.
182     * @return a list of isolating intervalls for the real roots of f.
183     */
184    public abstract List<Interval<C>> realRoots(GenPolynomial<C> f);
185
186
187    /**
188     * Isolating intervals for the real roots.
189     * @param f univariate polynomial.
190     * @param eps requested intervals length.
191     * @return a list of isolating intervals v such that |v| &lt; eps.
192     */
193    public List<Interval<C>> realRoots(GenPolynomial<C> f, C eps) {
194        return realRoots(f, eps.getRational());
195    }
196
197
198    /**
199     * Isolating intervals for the real roots.
200     * @param f univariate polynomial.
201     * @param eps requested intervals length.
202     * @return a list of isolating intervals v such that |v| &lt; eps.
203     */
204    public List<Interval<C>> realRoots(GenPolynomial<C> f, BigRational eps) {
205        List<Interval<C>> iv = realRoots(f);
206        return refineIntervals(iv, f, eps);
207    }
208
209
210    /**
211     * Sign changes on interval bounds.
212     * @param iv root isolating interval with f(left) * f(right) != 0.
213     * @param f univariate polynomial.
214     * @return true if f(left) * f(right) &lt; 0, else false
215     */
216    public boolean signChange(Interval<C> iv, GenPolynomial<C> f) {
217        if (f == null) {
218            return false;
219        }
220        RingFactory<C> cfac = f.ring.coFac;
221        C l = PolyUtil.<C> evaluateMain(cfac, f, iv.left);
222        C r = PolyUtil.<C> evaluateMain(cfac, f, iv.right);
223        return l.signum() * r.signum() < 0;
224    }
225
226
227    /**
228     * Number of real roots in interval.
229     * @param iv interval with f(left) * f(right) != 0.
230     * @param f univariate polynomial.
231     * @return number of real roots of f in I.
232     */
233    public abstract long realRootCount(Interval<C> iv, GenPolynomial<C> f);
234
235
236    /**
237     * Half interval.
238     * @param iv root isolating interval with f(left) * f(right) &lt; 0.
239     * @param f univariate polynomial, non-zero.
240     * @return a new interval v such that |v| &lt; |iv|/2.
241     */
242    public Interval<C> halfInterval(Interval<C> iv, GenPolynomial<C> f) {
243        if (f == null || f.isZERO()) {
244            return iv;
245        }
246        BigRational len = iv.rationalLength();
247        BigRational two = len.factory().fromInteger(2);
248        BigRational eps = len.divide(two);
249        return refineInterval(iv, f, eps);
250    }
251
252
253    /**
254     * Refine interval.
255     * @param iv root isolating interval with f(left) * f(right) &lt; 0.
256     * @param f univariate polynomial, non-zero.
257     * @param eps requested interval length.
258     * @return a new interval v such that |v| &lt; eps.
259     */
260    public Interval<C> refineInterval(Interval<C> iv, GenPolynomial<C> f, BigRational eps) {
261        if (f == null || f.isZERO() || f.isConstant() || eps == null) {
262            return iv;
263        }
264        if (iv.rationalLength().compareTo(eps) < 0) {
265            return iv;
266        }
267        RingFactory<C> cfac = f.ring.coFac;
268        C two = cfac.fromInteger(2);
269        Interval<C> v = iv;
270        while (v.rationalLength().compareTo(eps) >= 0) {
271            C c = v.left.sum(v.right);
272            c = c.divide(two);
273            //System.out.println("c = " + c);
274            //c = RootUtil.<C>bisectionPoint(v,f);
275            if (PolyUtil.<C> evaluateMain(cfac, f, c).isZERO()) {
276                v = new Interval<C>(c, c);
277                break;
278            }
279            Interval<C> iv1 = new Interval<C>(v.left, c);
280            if (signChange(iv1, f)) {
281                v = iv1;
282            } else {
283                v = new Interval<C>(c, v.right);
284            }
285        }
286        return v;
287    }
288
289
290    /**
291     * Refine intervals.
292     * @param V list of isolating intervals with f(left) * f(right) &lt; 0.
293     * @param f univariate polynomial, non-zero.
294     * @param eps requested intervals length.
295     * @return a list of new intervals v such that |v| &lt; eps.
296     */
297    public List<Interval<C>> refineIntervals(List<Interval<C>> V, GenPolynomial<C> f, BigRational eps) {
298        if (f == null || f.isZERO() || f.isConstant() || eps == null) {
299            return V;
300        }
301        List<Interval<C>> IV = new ArrayList<Interval<C>>();
302        for (Interval<C> v : V) {
303            Interval<C> iv = refineInterval(v, f, eps);
304            IV.add(iv);
305        }
306        return IV;
307    }
308
309
310    /**
311     * Invariant interval for algebraic number sign.
312     * @param iv root isolating interval for f, with f(left) * f(right) &lt; 0.
313     * @param f univariate polynomial, non-zero.
314     * @param g univariate polynomial, gcd(f,g) == 1.
315     * @return v with v a new interval contained in iv such that g(v) != 0.
316     */
317    public abstract Interval<C> invariantSignInterval(Interval<C> iv, GenPolynomial<C> f, GenPolynomial<C> g);
318
319
320    /**
321     * Real algebraic number sign.
322     * @param iv root isolating interval for f, with f(left) * f(right) &lt; 0,
323     *            with iv such that g(iv) != 0.
324     * @param f univariate polynomial, non-zero.
325     * @param g univariate polynomial, gcd(f,g) == 1.
326     * @return sign(g(iv)) .
327     */
328    public int realIntervalSign(Interval<C> iv, GenPolynomial<C> f, GenPolynomial<C> g) {
329        if (g == null || g.isZERO()) {
330            return 0;
331        }
332        if (f == null || f.isZERO() || f.isConstant()) {
333            return g.signum();
334        }
335        if (g.isConstant()) {
336            return g.signum();
337        }
338        RingFactory<C> cfac = f.ring.coFac;
339        C c = iv.left.sum(iv.right);
340        c = c.divide(cfac.fromInteger(2));
341        C ev = PolyUtil.<C> evaluateMain(cfac, g, c);
342        //System.out.println("ev = " + ev);
343        return ev.signum();
344    }
345
346
347    /**
348     * Real algebraic number sign.
349     * @param iv root isolating interval for f, with f(left) * f(right) &lt; 0.
350     * @param f univariate polynomial, non-zero.
351     * @param g univariate polynomial, gcd(f,g) == 1.
352     * @return sign(g(v)), with v a new interval contained in iv such that g(v)
353     *         != 0.
354     */
355    public int realSign(Interval<C> iv, GenPolynomial<C> f, GenPolynomial<C> g) {
356        if (g == null || g.isZERO()) {
357            return 0;
358        }
359        if (f == null || f.isZERO() || f.isConstant()) {
360            return g.signum();
361        }
362        if (g.isConstant()) {
363            return g.signum();
364        }
365        Interval<C> v = invariantSignInterval(iv, f, g);
366        return realIntervalSign(v, f, g);
367    }
368
369
370    /**
371     * Invariant interval for algebraic number magnitude.
372     * @param iv root isolating interval for f, with f(left) * f(right) &lt; 0.
373     * @param f univariate polynomial, non-zero.
374     * @param g univariate polynomial, gcd(f,g) == 1.
375     * @param eps length limit for interval length.
376     * @return v with v a new interval contained in iv such that |g(a) - g(b)|
377     *         &lt; eps for a, b in v in iv.
378     */
379    public Interval<C> invariantMagnitudeInterval(Interval<C> iv, GenPolynomial<C> f, GenPolynomial<C> g,
380                    BigRational eps) {
381        Interval<C> v = iv;
382        if (g == null || g.isZERO()) {
383            return v;
384        }
385        if (g.isConstant()) {
386            return v;
387        }
388        if (f == null || f.isZERO() || f.isConstant()) { // ?
389            return v;
390        }
391        GenPolynomial<C> gp = PolyUtil.<C> baseDeriviative(g);
392        //System.out.println("g  = " + g);
393        //System.out.println("gp = " + gp);
394        C B = magnitudeBound(iv, gp);
395        //System.out.println("B = " + B);
396
397        RingFactory<C> cfac = f.ring.coFac;
398        C two = cfac.fromInteger(2);
399
400        while (B.multiply(v.length()).getRational().compareTo(eps) >= 0) {
401            C c = v.left.sum(v.right);
402            c = c.divide(two);
403            Interval<C> im = new Interval<C>(c, v.right);
404            if (signChange(im, f)) {
405                v = im;
406            } else {
407                v = new Interval<C>(v.left, c);
408            }
409            //System.out.println("v = " + v.toDecimal());
410        }
411        return v;
412    }
413
414
415    /**
416     * Real algebraic number magnitude.
417     * @param iv root isolating interval for f, with f(left) * f(right) &lt; 0,
418     *            with iv such that |g(a) - g(b)| &lt; eps for a, b in iv.
419     * @param f univariate polynomial, non-zero.
420     * @param g univariate polynomial, gcd(f,g) == 1.
421     * @return g(iv) .
422     */
423    public C realIntervalMagnitude(Interval<C> iv, GenPolynomial<C> f, GenPolynomial<C> g) {
424        if (g.isZERO() || g.isConstant()) {
425            return g.leadingBaseCoefficient();
426        }
427        RingFactory<C> cfac = f.ring.coFac;
428        //if (false) {
429        //    C c = iv.left.sum(iv.right);
430        //    c = c.divide(cfac.fromInteger(2));
431        //    C ev = PolyUtil.<C> evaluateMain(cfac, g, c);
432        //    return ev;
433        //}
434        C evl = PolyUtil.<C> evaluateMain(cfac, g, iv.left);
435        C evr = PolyUtil.<C> evaluateMain(cfac, g, iv.right);
436        C ev = evl;
437        if (evl.compareTo(evr) <= 0) {
438            ev = evr;
439        }
440        //System.out.println("ev = " + ev + ", evl = " + evl + ", evr = " + evr + ", iv = " + iv);
441        return ev;
442    }
443
444
445    /**
446     * Real algebraic number magnitude.
447     * @param iv root isolating interval for f, with f(left) * f(right) &lt; 0.
448     * @param f univariate polynomial, non-zero.
449     * @param g univariate polynomial, gcd(f,g) == 1.
450     * @param eps length limit for interval length.
451     * @return g(iv) .
452     */
453    public C realMagnitude(Interval<C> iv, GenPolynomial<C> f, GenPolynomial<C> g, BigRational eps) {
454        if (g.isZERO() || g.isConstant()) {
455            return g.leadingBaseCoefficient();
456        }
457        Interval<C> v = invariantMagnitudeInterval(iv, f, g, eps);
458        return realIntervalMagnitude(v, f, g);
459    }
460
461
462    /**
463     * Approximate real root.
464     * @param iv real root isolating interval with f(left) * f(right) &lt; 0.
465     * @param f univariate polynomial, non-zero.
466     * @param eps requested interval length.
467     * @return a decimal approximation d such that |d-v| &lt; eps, for f(v) = 0,
468     *         v real.
469     */
470    public BigDecimal approximateRoot(Interval<C> iv, GenPolynomial<C> f, BigRational eps)
471                    throws NoConvergenceException {
472        if (iv == null) {
473            throw new IllegalArgumentException("null interval not allowed");
474        }
475        BigDecimal d = iv.toDecimal();
476        if (f == null || f.isZERO() || f.isConstant() || eps == null) {
477            return d;
478        }
479        if (iv.rationalLength().compareTo(eps) < 0) {
480            return d;
481        }
482        BigDecimal left = new BigDecimal(iv.left.getRational());
483        BigDecimal right = new BigDecimal(iv.right.getRational());
484        BigRational reps = eps.getRational();
485        BigDecimal e = new BigDecimal(reps);
486        BigDecimal q = new BigDecimal("0.25");
487        //System.out.println("left  = " + left);
488        //System.out.println("right = " + right);
489        e = e.multiply(d); // relative error
490        //System.out.println("e     = " + e);
491        BigDecimal dc = BigDecimal.ONE;
492        // polynomials with decimal coefficients
493        GenPolynomialRing<BigDecimal> dfac = new GenPolynomialRing<BigDecimal>(dc, f.ring);
494        GenPolynomial<BigDecimal> df = PolyUtil.<C> decimalFromRational(dfac, f);
495        GenPolynomial<C> fp = PolyUtil.<C> baseDeriviative(f);
496        GenPolynomial<BigDecimal> dfp = PolyUtil.<C> decimalFromRational(dfac, fp);
497
498        // Newton Raphson iteration: x_{n+1} = x_n - f(x_n)/f'(x_n)
499        int i = 0;
500        final int MITER = 50;
501        int dir = 0;
502        while (i++ < MITER) {
503            BigDecimal fx = PolyUtil.<BigDecimal> evaluateMain(dc, df, d); // f(d)
504            if (fx.isZERO()) {
505                return d;
506            }
507            BigDecimal fpx = PolyUtil.<BigDecimal> evaluateMain(dc, dfp, d); // f'(d)
508            if (fpx.isZERO()) {
509                throw new NoConvergenceException("zero deriviative should not happen");
510            }
511            BigDecimal x = fx.divide(fpx);
512            BigDecimal dx = d.subtract(x);
513            //System.out.println("dx = " + dx + ", d = " + d);
514            if (d.subtract(dx).abs().compareTo(e) <= 0) {
515                return dx;
516            }
517            while (dx.compareTo(left) < 0 || dx.compareTo(right) > 0) {
518                // dx < left: dx - left < 0
519                // dx > right: dx - right > 0
520                //System.out.println("trying to leave interval");
521                if (i++ > MITER) { // dx > right: dx - right > 0
522                    throw new NoConvergenceException("no convergence after " + i + " steps");
523                }
524                if (i > MITER / 2 && dir == 0) {
525                    BigDecimal sd = new BigDecimal(iv.randomPoint().getRational());
526                    d = sd;
527                    x = sd.getZERO();
528                    logger.info("trying new random starting point " + d);
529                    i = 0;
530                    dir = 1;
531                }
532                if (i > MITER / 2 && dir == 1) {
533                    BigDecimal sd = new BigDecimal(iv.randomPoint().getRational());
534                    d = sd;
535                    x = sd.getZERO();
536                    logger.info("trying new random starting point " + d);
537                    //i = 0;
538                    dir = 2; // end
539                }
540                x = x.multiply(q); // x * 1/4
541                dx = d.subtract(x);
542                //System.out.println(" x = " + x);
543                //System.out.println("dx = " + dx);
544            }
545            d = dx;
546        }
547        throw new NoConvergenceException("no convergence after " + i + " steps");
548    }
549
550
551    /**
552     * Approximate real roots.
553     * @param f univariate polynomial, non-zero.
554     * @param eps requested interval length.
555     * @return a list of decimal approximations d such that |d-v| &lt; eps for
556     *         all real v with f(v) = 0.
557     */
558    public List<BigDecimal> approximateRoots(GenPolynomial<C> f, BigRational eps) {
559        List<Interval<C>> iv = realRoots(f);
560        List<BigDecimal> roots = new ArrayList<BigDecimal>(iv.size());
561        for (Interval<C> i : iv) {
562            BigDecimal r = null; //approximateRoot(i, f, eps); roots.add(r);
563            while (r == null) {
564                try {
565                    r = approximateRoot(i, f, eps);
566                    roots.add(r);
567                } catch (NoConvergenceException e) {
568                    // fall back to exact algorithm
569                    //System.out.println("" + e);
570                    BigRational len = i.rationalLength();
571                    len = len.divide(len.factory().fromInteger(1000));
572                    i = refineInterval(i, f, len);
573                    logger.info("fall back rootRefinement = " + i);
574                }
575            }
576        }
577        return roots;
578    }
579
580
581    /**
582     * Test if x is an approximate real root.
583     * @param x approximate real root.
584     * @param f univariate polynomial, non-zero.
585     * @param eps requested interval length.
586     * @return true if x is a decimal approximation of a real v with f(v) = 0
587     *         with |d-v| &lt; eps, else false.
588     */
589    public boolean isApproximateRoot(BigDecimal x, GenPolynomial<C> f, C eps) {
590        if (x == null) {
591            throw new IllegalArgumentException("null root not allowed");
592        }
593        if (f == null || f.isZERO() || f.isConstant() || eps == null) {
594            return true;
595        }
596        BigDecimal e = new BigDecimal(eps.getRational());
597        e = e.multiply(new BigDecimal("1000")); // relax
598        BigDecimal dc = BigDecimal.ONE;
599        // polynomials with decimal coefficients
600        GenPolynomialRing<BigDecimal> dfac = new GenPolynomialRing<BigDecimal>(dc, f.ring);
601        GenPolynomial<BigDecimal> df = PolyUtil.<C> decimalFromRational(dfac, f);
602        GenPolynomial<C> fp = PolyUtil.<C> baseDeriviative(f);
603        GenPolynomial<BigDecimal> dfp = PolyUtil.<C> decimalFromRational(dfac, fp);
604        //
605        return isApproximateRoot(x, df, dfp, e);
606    }
607
608
609    /**
610     * Test if x is an approximate real root.
611     * @param x approximate real root.
612     * @param f univariate polynomial, non-zero.
613     * @param fp univariate polynomial, non-zero, deriviative of f.
614     * @param eps requested interval length.
615     * @return true if x is a decimal approximation of a real v with f(v) = 0
616     *         with |d-v| &lt; eps, else false.
617     */
618    public boolean isApproximateRoot(BigDecimal x, GenPolynomial<BigDecimal> f, GenPolynomial<BigDecimal> fp,
619                    BigDecimal eps) {
620        if (x == null) {
621            throw new IllegalArgumentException("null root not allowed");
622        }
623        if (f == null || f.isZERO() || f.isConstant() || eps == null) {
624            return true;
625        }
626        BigDecimal dc = BigDecimal.ONE; // only for clarity
627        // f(x)
628        BigDecimal fx = PolyUtil.<BigDecimal> evaluateMain(dc, f, x);
629        //System.out.println("fx    = " + fx);
630        if (fx.isZERO()) {
631            return true;
632        }
633        // f'(x)
634        BigDecimal fpx = PolyUtil.<BigDecimal> evaluateMain(dc, fp, x); // f'(d)
635        //System.out.println("fpx   = " + fpx);
636        if (fpx.isZERO()) {
637            return false;
638        }
639        BigDecimal d = fx.divide(fpx);
640        if (d.isZERO()) {
641            return true;
642        }
643        if (d.abs().compareTo(eps) <= 0) {
644            return true;
645        }
646        System.out.println("x     = " + x);
647        System.out.println("d     = " + d);
648        return false;
649    }
650
651
652    /**
653     * Test if each x in R is an approximate real root.
654     * @param R ist of approximate real roots.
655     * @param f univariate polynomial, non-zero.
656     * @param eps requested interval length.
657     * @return true if each x in R is a decimal approximation of a real v with
658     *         f(v) = 0 with |d-v| &lt; eps, else false.
659     */
660    public boolean isApproximateRoot(List<BigDecimal> R, GenPolynomial<C> f, BigRational eps) {
661        if (R == null) {
662            throw new IllegalArgumentException("null root not allowed");
663        }
664        if (f == null || f.isZERO() || f.isConstant() || eps == null) {
665            return true;
666        }
667        BigDecimal e = new BigDecimal(eps.getRational());
668        e = e.multiply(new BigDecimal("1000")); // relax
669        BigDecimal dc = BigDecimal.ONE;
670        // polynomials with decimal coefficients
671        GenPolynomialRing<BigDecimal> dfac = new GenPolynomialRing<BigDecimal>(dc, f.ring);
672        GenPolynomial<BigDecimal> df = PolyUtil.<C> decimalFromRational(dfac, f);
673        GenPolynomial<C> fp = PolyUtil.<C> baseDeriviative(f);
674        GenPolynomial<BigDecimal> dfp = PolyUtil.<C> decimalFromRational(dfac, fp);
675        for (BigDecimal x : R) {
676            if (!isApproximateRoot(x, df, dfp, e)) {
677                return false;
678            }
679        }
680        return true;
681    }
682
683}