diff options
Diffstat (limited to 'doc/source/reference/routines.polynomials.rst')
| -rw-r--r-- | doc/source/reference/routines.polynomials.rst | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/doc/source/reference/routines.polynomials.rst b/doc/source/reference/routines.polynomials.rst index 59d6bc499..94d1af8e7 100644 --- a/doc/source/reference/routines.polynomials.rst +++ b/doc/source/reference/routines.polynomials.rst @@ -1,14 +1,23 @@ Polynomials *********** -The poly1d functions are considered outdated but are retained for -backward compatibility. New software needing polynomials should -use the classes in the Polynomial Package. +The polynomial package is newer and more complete than poly1d and the +convenience classes are better behaved in the numpy environment. When +backwards compatibility is not an issue it should be the package of choice. +Note that the various routines in the polynomial package all deal with +series whose coefficients go from degree zero upward, which is the reverse +of the poly1d convention. The easy way to remember this is that indexes +correspond to degree, i.e., coef[i] is the coefficient of the term of +degree i. + .. toctree:: :maxdepth: 2 - routines.polynomials.polynomial routines.polynomials.poly1d +.. toctree:: + :maxdepth: 3 + + routines.polynomials.package |