X-Git-Url: https://www.ginac.de/ginac.git//ginac.git?p=ginac.git;a=blobdiff_plain;f=ginac%2Fpseries.h;h=2857bb7e7cfc0fcaca4ac39c35a112fdca1c7da4;hp=9346c2556f8de5291d1aa3b040a3b8cccfac1edf;hb=9d9503cff68b40c4c5f6a2f9eb7ae9b32c53a486;hpb=80b2042a896022bc5d774b27aa9f56a42a082a6f diff --git a/ginac/pseries.h b/ginac/pseries.h index 9346c255..2857bb7e 100644 --- a/ginac/pseries.h +++ b/ginac/pseries.h @@ -3,7 +3,7 @@ * Interface to class for extended truncated power series. */ /* - * GiNaC Copyright (C) 1999-2000 Johannes Gutenberg University Mainz, Germany + * GiNaC Copyright (C) 1999-2020 Johannes Gutenberg University Mainz, Germany * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -17,18 +17,16 @@ * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software - * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ -#ifndef __GINAC_SERIES_H__ -#define __GINAC_SERIES_H__ +#ifndef GINAC_SERIES_H +#define GINAC_SERIES_H #include "basic.h" #include "expairseq.h" -#ifndef NO_NAMESPACE_GINAC namespace GiNaC { -#endif // ndef NO_NAMESPACE_GINAC /** This class holds a extended truncated power series (positive and negative * integer powers). It consists of expression coefficients (only non-zero @@ -36,79 +34,96 @@ namespace GiNaC { * Other classes must provide members to convert into this type. */ class pseries : public basic { - GINAC_DECLARE_REGISTERED_CLASS(pseries, basic) + GINAC_DECLARE_REGISTERED_CLASS(pseries, basic) - // default constructor, destructor, copy constructor, assignment operator and helpers + // other constructors public: - pseries(); - ~pseries(); - pseries(const pseries &other); - const pseries &operator=(const pseries &other); -protected: - void copy(const pseries &other); - void destroy(bool call_parent); - - // other constructors -public: - pseries(const ex &rel_, const epvector &ops_); + pseries(const ex &rel_, const epvector &ops_); + pseries(const ex &rel_, epvector &&ops_); - // functions overriding virtual functions from base classes + // functions overriding virtual functions from base classes public: - basic *duplicate() const; - void print(ostream &os, unsigned upper_precedence=0) const; - void printraw(ostream &os) const; - void printtree(ostream & os, unsigned indent) const; - unsigned nops(void) const; - ex op(int i) const; - ex &let_op(int i); - int degree(const symbol &s) const; - int ldegree(const symbol &s) const; - ex coeff(const symbol &s, int n=1) const; - ex collect(const symbol &s) const; - ex eval(int level=0) const; - ex evalf(int level=0) const; - ex series(const relational & r, int order) const; - ex normal(lst &sym_lst, lst &repl_lst, int level=0) const; - ex subs(const lst & ls, const lst & lr) const; + unsigned precedence() const override {return 38;} // for clarity just below add::precedence + size_t nops() const override; + ex op(size_t i) const override; + int degree(const ex &s) const override; + int ldegree(const ex &s) const override; + ex coeff(const ex &s, int n = 1) const override; + ex collect(const ex &s, bool distributed = false) const override; + ex eval() const override; + ex evalf() const override; + ex series(const relational & r, int order, unsigned options = 0) const override; + ex subs(const exmap & m, unsigned options = 0) const override; + ex normal(exmap & repl, exmap & rev_lookup, lst & modifier) const override; + ex expand(unsigned options = 0) const override; + ex conjugate() const override; + ex real_part() const override; + ex imag_part() const override; + ex eval_integ() const override; + ex evalm() const override; + /** Save (a.k.a. serialize) object into archive. */ + void archive(archive_node& n) const override; + /** Read (a.k.a. deserialize) object from archive. */ + void read_archive(const archive_node& n, lst& syms) override; protected: - ex derivative(const symbol & s) const; + ex derivative(const symbol & s) const override; - // non-virtual functions in this class + // non-virtual functions in this class public: - ex convert_to_poly(bool no_order = false) const; - bool is_compatible_to(const pseries &other) const {return var.compare(other.var) == 0 && point.compare(other.point) == 0;} - bool is_zero(void) const {return seq.size() == 0;} - ex add_series(const pseries &other) const; - ex mul_const(const numeric &other) const; - ex mul_series(const pseries &other) const; - ex power_const(const numeric &p, int deg) const; + /** Get the expansion variable. */ + ex get_var() const {return var;} + + /** Get the expansion point. */ + ex get_point() const {return point;} + + /** Convert the pseries object to an ordinary polynomial. + * + * @param no_order flag: discard higher order terms */ + ex convert_to_poly(bool no_order = false) const; + + /** Check whether series is compatible to another series (expansion + * variable and point are the same. */ + bool is_compatible_to(const pseries &other) const {return var.is_equal(other.var) && point.is_equal(other.point);} + + /** Check whether series has the value zero. */ + bool is_zero() const {return seq.size() == 0;} + + /** Returns true if there is no order term, i.e. the series terminates and + * false otherwise. */ + bool is_terminating() const; + + /** Get coefficients and exponents. */ + ex coeffop(size_t i) const; + ex exponop(size_t i) const; + + ex add_series(const pseries &other) const; + ex mul_const(const numeric &other) const; + ex mul_series(const pseries &other) const; + ex power_const(const numeric &p, int deg) const; + pseries shift_exponents(int deg) const; protected: - /** Vector of {coefficient, power} pairs */ - epvector seq; + void print_series(const print_context & c, const char *openbrace, const char *closebrace, const char *mul_sym, const char *pow_sym, unsigned level) const; + void do_print(const print_context & c, unsigned level) const; + void do_print_latex(const print_latex & c, unsigned level) const; + void do_print_tree(const print_tree & c, unsigned level) const; + void do_print_python(const print_python & c, unsigned level) const; + void do_print_python_repr(const print_python_repr & c, unsigned level) const; - /** Series variable (holds a symbol) */ - ex var; +protected: + /** Vector of {coefficient, power} pairs */ + epvector seq; + + /** Series variable (holds a symbol) */ + ex var; - /** Expansion point */ - ex point; + /** Expansion point */ + ex point; }; +GINAC_DECLARE_UNARCHIVER(pseries); -// global constants -extern const pseries some_pseries; -extern const type_info & typeid_pseries; -/** Return a reference to the pseries object embedded in an expression. - * The result is undefined if the expression does not contain a pseries - * object at its top level. - * - * @param e expression - * @return reference to pseries object - * @see is_ex_of_type */ -inline const pseries &ex_to_pseries(const ex &e) -{ - return static_cast(*e.bp); -} +// utility functions /** Convert the pseries object embedded in an expression to an ordinary * polynomial in the expansion variable. The result is undefined if the @@ -116,15 +131,18 @@ inline const pseries &ex_to_pseries(const ex &e) * * @param e expression * @return polynomial expression - * @see is_ex_of_type + * @see is_a<> * @see pseries::convert_to_poly */ inline ex series_to_poly(const ex &e) { - return (static_cast(*e.bp).convert_to_poly(true)); + return (ex_to(e).convert_to_poly(true)); +} + +inline bool is_terminating(const pseries & s) +{ + return s.is_terminating(); } -#ifndef NO_NAMESPACE_GINAC } // namespace GiNaC -#endif // ndef NO_NAMESPACE_GINAC -#endif // ndef __GINAC_SERIES_H__ +#endif // ndef GINAC_SERIES_H