* This file implements several functions that work on univariate and
* multivariate polynomials and rational functions.
* These functions include polynomial quotient and remainder, GCD and LCM
- * computation, square-free factorization and rational function normalization.
- */
+ * computation, square-free factorization and rational function normalization. */
/*
* GiNaC Copyright (C) 1999-2000 Johannes Gutenberg University Mainz, Germany
* @param e expression to search
* @param x pointer to first symbol found (returned)
* @return "false" if no symbol was found, "true" otherwise */
-
static bool get_first_symbol(const ex &e, const symbol *&x)
{
if (is_ex_exactly_of_type(e, symbol)) {
/** Lowest degree of symbol in polynomial "b" */
int ldeg_b;
- /** Minimum of ldeg_a and ldeg_b (Used for sorting) */
- int min_deg;
+ /** Maximum of deg_a and deg_b (Used for sorting) */
+ int max_deg;
/** Commparison operator for sorting */
- bool operator<(const sym_desc &x) const {return min_deg < x.min_deg;}
+ bool operator<(const sym_desc &x) const {return max_deg < x.max_deg;}
};
// Vector of sym_desc structures
* @param a first multivariate polynomial
* @param b second multivariate polynomial
* @param v vector of sym_desc structs (filled in) */
-
static void get_symbol_stats(const ex &a, const ex &b, sym_desc_vec &v)
{
collect_symbols(a.eval(), v); // eval() to expand assigned symbols
int deg_b = b.degree(*(it->sym));
it->deg_a = deg_a;
it->deg_b = deg_b;
- it->min_deg = min(deg_a, deg_b);
+ it->max_deg = max(deg_a, deg_b);
it->ldeg_a = a.ldegree(*(it->sym));
it->ldeg_b = b.ldegree(*(it->sym));
it++;
}
sort(v.begin(), v.end());
+#if 0
+ clog << "Symbols:\n";
+ it = v.begin(); itend = v.end();
+ while (it != itend) {
+ clog << " " << *it->sym << ": deg_a=" << it->deg_a << ", deg_b=" << it->deg_b << ", ldeg_a=" << it->ldeg_a << ", ldeg_b=" << it->ldeg_b << ", max_deg=" << it->max_deg << endl;
+ clog << " lcoeff_a=" << a.lcoeff(*(it->sym)) << ", lcoeff_b=" << b.lcoeff(*(it->sym)) << endl;
+ it++;
+ }
+#endif
}
*
* @param e multivariate polynomial (need not be expanded)
* @return LCM of denominators of coefficients */
-
static numeric lcm_of_coefficients_denominators(const ex &e)
{
return lcmcoeff(e, _num1());
*
* @param e multivariate polynomial (need not be expanded)
* @param lcm LCM to multiply in */
-
static ex multiply_lcm(const ex &e, const numeric &lcm)
{
if (is_ex_exactly_of_type(e, mul)) {
*
* @param e expanded polynomial
* @return integer content */
-
numeric ex::integer_content(void) const
{
GINAC_ASSERT(bp!=0);
* @param check_args check whether a and b are polynomials with rational
* coefficients (defaults to "true")
* @return quotient of a and b in Q[x] */
-
ex quo(const ex &a, const ex &b, const symbol &x, bool check_args)
{
if (b.is_zero())
* @param check_args check whether a and b are polynomials with rational
* coefficients (defaults to "true")
* @return remainder of a(x) and b(x) in Q[x] */
-
ex rem(const ex &a, const ex &b, const symbol &x, bool check_args)
{
if (b.is_zero())
* @param check_args check whether a and b are polynomials with rational
* coefficients (defaults to "true")
* @return pseudo-remainder of a(x) and b(x) in Z[x] */
-
ex prem(const ex &a, const ex &b, const symbol &x, bool check_args)
{
if (b.is_zero())
* coefficients (defaults to "true")
* @return "true" when exact division succeeds (quotient returned in q),
* "false" otherwise */
-
bool divide(const ex &a, const ex &b, ex &q, bool check_args)
{
q = _ex0();
if (b.is_zero())
throw(std::overflow_error("divide: division by zero"));
+ if (a.is_zero())
+ return true;
if (is_ex_exactly_of_type(b, numeric)) {
q = a / b;
return true;
return true;
}
#endif
- if (check_args && (!a.info(info_flags::rational_polynomial) || !b.info(info_flags::rational_polynomial)))
+ if (check_args && (!a.info(info_flags::rational_polynomial) ||
+ !b.info(info_flags::rational_polynomial)))
throw(std::invalid_argument("divide: arguments must be polynomials over the rationals"));
// Find first symbol
* @param x variable in which to compute the primitive part
* @param c previously computed content part
* @return primitive part */
-
ex ex::primpart(const symbol &x, const ex &c) const
{
if (is_zero())
* GCD of multivariate polynomials
*/
-/** Compute GCD of multivariate polynomials using the subresultant PRS
- * algorithm. This function is used internally gy gcd().
+/** Compute GCD of multivariate polynomials using the Euclidean PRS algorithm
+ * (not really suited for multivariate GCDs). This function is only provided
+ * for testing purposes.
+ *
+ * @param a first multivariate polynomial
+ * @param b second multivariate polynomial
+ * @param x pointer to symbol (main variable) in which to compute the GCD in
+ * @return the GCD as a new expression
+ * @see gcd */
+
+static ex eu_gcd(const ex &a, const ex &b, const symbol *x)
+{
+//clog << "eu_gcd(" << a << "," << b << ")\n";
+
+ // Sort c and d so that c has higher degree
+ ex c, d;
+ int adeg = a.degree(*x), bdeg = b.degree(*x);
+ if (adeg >= bdeg) {
+ c = a;
+ d = b;
+ } else {
+ c = b;
+ d = a;
+ }
+
+ // Euclidean algorithm
+ ex r;
+ for (;;) {
+//clog << " d = " << d << endl;
+ r = rem(c, d, *x, false);
+ if (r.is_zero())
+ return d.primpart(*x);
+ c = d;
+ d = r;
+ }
+}
+
+
+/** Compute GCD of multivariate polynomials using the Euclidean PRS algorithm
+ * with pseudo-remainders ("World's Worst GCD Algorithm", staying in Z[X]).
+ * This function is only provided for testing purposes.
*
* @param a first multivariate polynomial
* @param b second multivariate polynomial
* @return the GCD as a new expression
* @see gcd */
+static ex euprem_gcd(const ex &a, const ex &b, const symbol *x)
+{
+//clog << "euprem_gcd(" << a << "," << b << ")\n";
+
+ // Sort c and d so that c has higher degree
+ ex c, d;
+ int adeg = a.degree(*x), bdeg = b.degree(*x);
+ if (adeg >= bdeg) {
+ c = a;
+ d = b;
+ } else {
+ c = b;
+ d = a;
+ }
+
+ // Euclidean algorithm with pseudo-remainders
+ ex r;
+ for (;;) {
+//clog << " d = " << d << endl;
+ r = prem(c, d, *x, false);
+ if (r.is_zero())
+ return d.primpart(*x);
+ c = d;
+ d = r;
+ }
+}
+
+
+/** Compute GCD of multivariate polynomials using the primitive Euclidean
+ * PRS algorithm (complete content removal at each step). This function is
+ * only provided for testing purposes.
+ *
+ * @param a first multivariate polynomial
+ * @param b second multivariate polynomial
+ * @param x pointer to symbol (main variable) in which to compute the GCD in
+ * @return the GCD as a new expression
+ * @see gcd */
+
+static ex peu_gcd(const ex &a, const ex &b, const symbol *x)
+{
+//clog << "peu_gcd(" << a << "," << b << ")\n";
+
+ // Sort c and d so that c has higher degree
+ ex c, d;
+ int adeg = a.degree(*x), bdeg = b.degree(*x);
+ int ddeg;
+ if (adeg >= bdeg) {
+ c = a;
+ d = b;
+ ddeg = bdeg;
+ } else {
+ c = b;
+ d = a;
+ ddeg = adeg;
+ }
+
+ // Remove content from c and d, to be attached to GCD later
+ ex cont_c = c.content(*x);
+ ex cont_d = d.content(*x);
+ ex gamma = gcd(cont_c, cont_d, NULL, NULL, false);
+ if (ddeg == 0)
+ return gamma;
+ c = c.primpart(*x, cont_c);
+ d = d.primpart(*x, cont_d);
+
+ // Euclidean algorithm with content removal
+ ex r;
+ for (;;) {
+//clog << " d = " << d << endl;
+ r = prem(c, d, *x, false);
+ if (r.is_zero())
+ return gamma * d;
+ c = d;
+ d = r.primpart(*x);
+ }
+}
+
+
+/** Compute GCD of multivariate polynomials using the reduced PRS algorithm.
+ * This function is only provided for testing purposes.
+ *
+ * @param a first multivariate polynomial
+ * @param b second multivariate polynomial
+ * @param x pointer to symbol (main variable) in which to compute the GCD in
+ * @return the GCD as a new expression
+ * @see gcd */
+
+static ex red_gcd(const ex &a, const ex &b, const symbol *x)
+{
+//clog << "red_gcd(" << a << "," << b << ")\n";
+
+ // Sort c and d so that c has higher degree
+ ex c, d;
+ int adeg = a.degree(*x), bdeg = b.degree(*x);
+ int cdeg, ddeg;
+ if (adeg >= bdeg) {
+ c = a;
+ d = b;
+ cdeg = adeg;
+ ddeg = bdeg;
+ } else {
+ c = b;
+ d = a;
+ cdeg = bdeg;
+ ddeg = adeg;
+ }
+
+ // Remove content from c and d, to be attached to GCD later
+ ex cont_c = c.content(*x);
+ ex cont_d = d.content(*x);
+ ex gamma = gcd(cont_c, cont_d, NULL, NULL, false);
+ if (ddeg == 0)
+ return gamma;
+ c = c.primpart(*x, cont_c);
+ d = d.primpart(*x, cont_d);
+
+ // First element of subresultant sequence
+ ex r, ri = _ex1();
+ int delta = cdeg - ddeg;
+
+ for (;;) {
+ // Calculate polynomial pseudo-remainder
+//clog << " d = " << d << endl;
+ r = prem(c, d, *x, false);
+ if (r.is_zero())
+ return gamma * d.primpart(*x);
+ c = d;
+ cdeg = ddeg;
+
+ if (!divide(r, pow(ri, delta), d, false))
+ throw(std::runtime_error("invalid expression in red_gcd(), division failed"));
+ ddeg = d.degree(*x);
+ if (ddeg == 0) {
+ if (is_ex_exactly_of_type(r, numeric))
+ return gamma;
+ else
+ return gamma * r.primpart(*x);
+ }
+
+ ri = c.expand().lcoeff(*x);
+ delta = cdeg - ddeg;
+ }
+}
+
+
+/** Compute GCD of multivariate polynomials using the subresultant PRS
+ * algorithm. This function is used internally by gcd().
+ *
+ * @param a first multivariate polynomial
+ * @param b second multivariate polynomial
+ * @param x pointer to symbol (main variable) in which to compute the GCD in
+ * @return the GCD as a new expression
+ * @see gcd */
static ex sr_gcd(const ex &a, const ex &b, const symbol *x)
{
//clog << "sr_gcd(" << a << "," << b << ")\n";
for (;;) {
// Calculate polynomial pseudo-remainder
//clog << " start of loop, psi = " << psi << ", calculating pseudo-remainder...\n";
+//clog << " d = " << d << endl;
r = prem(c, d, *x, false);
if (r.is_zero())
return gamma * d.primpart(*x);
c = d;
cdeg = ddeg;
//clog << " dividing...\n";
- if (!divide(r, ri * power(psi, delta), d, false))
+ if (!divide(r, ri * pow(psi, delta), d, false))
throw(std::runtime_error("invalid expression in sr_gcd(), division failed"));
ddeg = d.degree(*x);
if (ddeg == 0) {
if (delta == 1)
psi = ri;
else if (delta)
- divide(power(ri, delta), power(psi, delta-1), psi, false);
+ divide(pow(ri, delta), pow(psi, delta-1), psi, false);
delta = cdeg - ddeg;
}
}
* @param e expanded multivariate polynomial
* @return maximum coefficient
* @see heur_gcd */
-
numeric ex::max_coefficient(void) const
{
GINAC_ASSERT(bp!=0);
* @param xi modulus
* @return mapped polynomial
* @see heur_gcd */
-
ex ex::smod(const numeric &xi) const
{
GINAC_ASSERT(bp!=0);
* @return the GCD as a new expression
* @see gcd
* @exception gcdheu_failed() */
-
static ex heur_gcd(const ex &a, const ex &b, ex *ca, ex *cb, sym_desc_vec::const_iterator var)
{
//clog << "heur_gcd(" << a << "," << b << ")\n";
* @param check_args check whether a and b are polynomials with rational
* coefficients (defaults to "true")
* @return the GCD as a new expression */
-
ex gcd(const ex &a, const ex &b, ex *ca, ex *cb, bool check_args)
{
//clog << "gcd(" << a << "," << b << ")\n";
return g;
}
- // Try heuristic algorithm first, fall back to PRS if that failed
ex g;
+#if 1
+ // Try heuristic algorithm first, fall back to PRS if that failed
try {
g = heur_gcd(aex, bex, ca, cb, var);
} catch (gcdheu_failed) {
#if STATISTICS
heur_gcd_failed++;
#endif
- g = sr_gcd(aex, bex, x);
+#endif
+// g = heur_gcd(aex, bex, ca, cb, var);
+// g = eu_gcd(aex, bex, x);
+// g = euprem_gcd(aex, bex, x);
+// g = peu_gcd(aex, bex, x);
+// g = red_gcd(aex, bex, x);
+ g = sr_gcd(aex, bex, x);
if (g.is_equal(_ex1())) {
// Keep cofactors factored if possible
if (ca)
if (cb)
divide(bex, g, *cb, false);
}
+#if 1
} else {
if (g.is_equal(_ex1())) {
// Keep cofactors factored if possible
if (cb)
*cb = b;
}
- return g;
}
+#endif
+ return g;
}
*/
/** Create a symbol for replacing the expression "e" (or return a previously
- * assigned symbol). The symbol is appended to sym_list and returned, the
- * expression is appended to repl_list.
+ * assigned symbol). The symbol is appended to sym_lst and returned, the
+ * expression is appended to repl_lst.
* @see ex::normal */
static ex replace_with_symbol(const ex &e, lst &sym_lst, lst &repl_lst)
{
for (unsigned i=0; i<repl_lst.nops(); i++)
if (repl_lst.op(i).is_equal(e))
return sym_lst.op(i);
-
+
// Otherwise create new symbol and add to list, taking care that the
// replacement expression doesn't contain symbols from the sym_lst
// because subs() is not recursive
return es;
}
+/** Create a symbol for replacing the expression "e" (or return a previously
+ * assigned symbol). An expression of the form "symbol == expression" is added
+ * to repl_lst and the symbol is returned.
+ * @see ex::to_rational */
+static ex replace_with_symbol(const ex &e, lst &repl_lst)
+{
+ // Expression already in repl_lst? Then return the assigned symbol
+ for (unsigned i=0; i<repl_lst.nops(); i++)
+ if (repl_lst.op(i).op(1).is_equal(e))
+ return repl_lst.op(i).op(0);
+
+ // Otherwise create new symbol and add to list, taking care that the
+ // replacement expression doesn't contain symbols from the sym_lst
+ // because subs() is not recursive
+ symbol s;
+ ex es(s);
+ ex e_replaced = e.subs(repl_lst);
+ repl_lst.append(es == e_replaced);
+ return es;
+}
/** Default implementation of ex::normal(). It replaces the object with a
* temporary symbol.
}
+/** Implementation of ex::normal() for relationals. It normalizes both sides.
+ * @see ex::normal */
+ex relational::normal(lst &sym_lst, lst &repl_lst, int level) const
+{
+ return (new lst(relational(lh.normal(), rh.normal(), o), _ex1()))->setflag(status_flags::dynallocated);
+}
+
+
/** Normalization of rational functions.
* This function converts an expression to its normal form
* "numerator/denominator", where numerator and denominator are (relatively
* prime) polynomials. Any subexpressions which are not rational functions
- * (like non-rational numbers, non-integer powers or functions like Sin(),
- * Cos() etc.) are replaced by temporary symbols which are re-substituted by
+ * (like non-rational numbers, non-integer powers or functions like sin(),
+ * cos() etc.) are replaced by temporary symbols which are re-substituted by
* the (normalized) subexpressions before normal() returns (this way, any
* expression can be treated as a rational function). normal() is applied
* recursively to arguments of functions etc.
return e.op(1);
}
+
+/** Default implementation of ex::to_rational(). It replaces the object with a
+ * temporary symbol.
+ * @see ex::to_rational */
+ex basic::to_rational(lst &repl_lst) const
+{
+ return replace_with_symbol(*this, repl_lst);
+}
+
+
+/** Implementation of ex::to_rational() for symbols. This returns the
+ * unmodified symbol.
+ * @see ex::to_rational */
+ex symbol::to_rational(lst &repl_lst) const
+{
+ return *this;
+}
+
+
+/** Implementation of ex::to_rational() for a numeric. It splits complex
+ * numbers into re+I*im and replaces I and non-rational real numbers with a
+ * temporary symbol.
+ * @see ex::to_rational */
+ex numeric::to_rational(lst &repl_lst) const
+{
+ if (is_real()) {
+ if (!is_rational())
+ return replace_with_symbol(*this, repl_lst);
+ } else { // complex
+ numeric re = real();
+ numeric im = imag();
+ ex re_ex = re.is_rational() ? re : replace_with_symbol(re, repl_lst);
+ ex im_ex = im.is_rational() ? im : replace_with_symbol(im, repl_lst);
+ return re_ex + im_ex * replace_with_symbol(I, repl_lst);
+ }
+ return *this;
+}
+
+
+/** Implementation of ex::to_rational() for powers. It replaces non-integer
+ * powers by temporary symbols.
+ * @see ex::to_rational */
+ex power::to_rational(lst &repl_lst) const
+{
+ if (exponent.info(info_flags::integer))
+ return power(basis.to_rational(repl_lst), exponent);
+ else
+ return replace_with_symbol(*this, repl_lst);
+}
+
+
+/** Implementation of ex::to_rational() for expairseqs.
+ * @see ex::to_rational */
+ex expairseq::to_rational(lst &repl_lst) const
+{
+ epvector s;
+ s.reserve(seq.size());
+ for (epvector::const_iterator it=seq.begin(); it!=seq.end(); ++it) {
+ s.push_back(split_ex_to_pair(recombine_pair_to_ex(*it).to_rational(repl_lst)));
+ // s.push_back(combine_ex_with_coeff_to_pair((*it).rest.to_rational(repl_lst),
+ }
+ ex oc = overall_coeff.to_rational(repl_lst);
+ if (oc.info(info_flags::numeric))
+ return thisexpairseq(s, overall_coeff);
+ else s.push_back(combine_ex_with_coeff_to_pair(oc,_ex1()));
+ return thisexpairseq(s, default_overall_coeff());
+}
+
+
+/** Rationalization of non-rational functions.
+ * This function converts a general expression to a rational polynomial
+ * by replacing all non-rational subexpressions (like non-rational numbers,
+ * non-integer powers or functions like sin(), cos() etc.) to temporary
+ * symbols. This makes it possible to use functions like gcd() and divide()
+ * on non-rational functions by applying to_rational() on the arguments,
+ * calling the desired function and re-substituting the temporary symbols
+ * in the result. To make the last step possible, all temporary symbols and
+ * their associated expressions are collected in the list specified by the
+ * repl_lst parameter in the form {symbol == expression}, ready to be passed
+ * as an argument to ex::subs().
+ *
+ * @param repl_lst collects a list of all temporary symbols and their replacements
+ * @return rationalized expression */
+ex ex::to_rational(lst &repl_lst) const
+{
+ return bp->to_rational(repl_lst);
+}
+
+
#ifndef NO_NAMESPACE_GINAC
} // namespace GiNaC
#endif // ndef NO_NAMESPACE_GINAC