diff options
Diffstat (limited to 'doc/source/reference/routines.polynomials.rst')
| -rw-r--r-- | doc/source/reference/routines.polynomials.rst | 27 |
1 files changed, 18 insertions, 9 deletions
diff --git a/doc/source/reference/routines.polynomials.rst b/doc/source/reference/routines.polynomials.rst index 3e9b2603f..e85d0549b 100644 --- a/doc/source/reference/routines.polynomials.rst +++ b/doc/source/reference/routines.polynomials.rst @@ -1,12 +1,22 @@ Polynomials *********** -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 +Polynomials in NumPy can be *created*, *manipulated*, and even *fitted* using +the :doc:`routines.polynomials.classes` +of the `numpy.polynomial` package, introduced in NumPy 1.4. + +Prior to NumPy 1.4, `numpy.poly1d` was the class of choice and it is still +available in order to maintain backward compatibility. +However, the newer Polynomial package is more complete than `numpy.poly1d` +and its convenience classes are better behaved in the numpy environment. +Therefore Polynomial is recommended for new coding. + +Transition notice +----------------- +The various routines in the Polynomial package all deal with +series whose coefficients go from degree zero upward, +which is the *reverse order* 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. @@ -14,10 +24,9 @@ degree i. .. toctree:: :maxdepth: 2 - routines.polynomials.poly1d - + routines.polynomials.package .. toctree:: :maxdepth: 2 - routines.polynomials.package + routines.polynomials.poly1d |