Polynomials¶
This chapter describes functions for evaluating and solving polynomials.
There are routines for finding real and complex roots of quadratic and
cubic equations using analytic methods. An iterative polynomial solver
is also available for finding the roots of general polynomials with real
coefficients (of any order). The functions are declared in the header
file gsl_poly.h
.
Polynomial Evaluation¶
The functions described here evaluate the polynomial
using Horner’s method for stability. Inline versions of these functions are used when HAVE_INLINE
is defined.

double
gsl_poly_eval
(const double c[], const int len, const double x)¶ This function evaluates a polynomial with real coefficients for the real variable
x
.

gsl_complex
gsl_poly_complex_eval
(const double c[], const int len, const gsl_complex z)¶ This function evaluates a polynomial with real coefficients for the complex variable
z
.

gsl_complex
gsl_complex_poly_complex_eval
(const gsl_complex c[], const int len, const gsl_complex z)¶ This function evaluates a polynomial with complex coefficients for the complex variable
z
.

int
gsl_poly_eval_derivs
(const double c[], const size_t lenc, const double x, double res[], const size_t lenres)¶ This function evaluates a polynomial and its derivatives storing the results in the array
res
of sizelenres
. The output array contains the values of for the specified value ofx
starting with .
Divided Difference Representation of Polynomials¶
The functions described here manipulate polynomials stored in Newton’s divideddifference representation. The use of divideddifferences is described in Abramowitz & Stegun sections 25.1.4 and 25.2.26, and Burden and Faires, chapter 3, and discussed briefly below.
Given a function , an th degree interpolating polynomial can be constructed which agrees with at distinct points . This polynomial can be written in a form known as Newton’s divideddifference representation
where the divided differences are defined in section 25.1.4 of Abramowitz and Stegun. Additionally, it is possible to construct an interpolating polynomial of degree which also matches the first derivatives of at the points . This is called the Hermite interpolating polynomial and is defined as
where the elements of are defined by . The divideddifferences are discussed in Burden and Faires, section 3.4.

int
gsl_poly_dd_init
(double dd[], const double xa[], const double ya[], size_t size)¶ This function computes a divideddifference representation of the interpolating polynomial for the points stored in the arrays
xa
andya
of lengthsize
. On output the divideddifferences of (xa
,ya
) are stored in the arraydd
, also of lengthsize
. Using the notation above, .

double
gsl_poly_dd_eval
(const double dd[], const double xa[], const size_t size, const double x)¶ This function evaluates the polynomial stored in divideddifference form in the arrays
dd
andxa
of lengthsize
at the pointx
. An inline version of this function is used whenHAVE_INLINE
is defined.

int
gsl_poly_dd_taylor
(double c[], double xp, const double dd[], const double xa[], size_t size, double w[])¶ This function converts the divideddifference representation of a polynomial to a Taylor expansion. The divideddifference representation is supplied in the arrays
dd
andxa
of lengthsize
. On output the Taylor coefficients of the polynomial expanded about the pointxp
are stored in the arrayc
also of lengthsize
. A workspace of lengthsize
must be provided in the arrayw
.

int
gsl_poly_dd_hermite_init
(double dd[], double za[], const double xa[], const double ya[], const double dya[], const size_t size)¶ This function computes a divideddifference representation of the interpolating Hermite polynomial for the points stored in the arrays
xa
andya
of lengthsize
. Hermite interpolation constructs polynomials which also match first derivatives which are provided in the arraydya
also of lengthsize
. The first derivatives can be incorported into the usual divideddifference algorithm by forming a new dataset , which is stored in the arrayza
of length 2*size
on output. On output the divideddifferences of the Hermite representation are stored in the arraydd
, also of length 2*size
. Using the notation above, . The resulting Hermite polynomial can be evaluated by callinggsl_poly_dd_eval()
and usingza
for the input argumentxa
.
Quadratic Equations¶

int
gsl_poly_solve_quadratic
(double a, double b, double c, double * x0, double * x1)¶ This function finds the real roots of the quadratic equation,
The number of real roots (either zero, one or two) is returned, and their locations are stored in
x0
andx1
. If no real roots are found thenx0
andx1
are not modified. If one real root is found (i.e. if ) then it is stored inx0
. When two real roots are found they are stored inx0
andx1
in ascending order. The case of coincident roots is not considered special. For example will have two roots, which happen to have exactly equal values.The number of roots found depends on the sign of the discriminant . This will be subject to rounding and cancellation errors when computed in double precision, and will also be subject to errors if the coefficients of the polynomial are inexact. These errors may cause a discrete change in the number of roots. However, for polynomials with small integer coefficients the discriminant can always be computed exactly.

int
gsl_poly_complex_solve_quadratic
(double a, double b, double c, gsl_complex * z0, gsl_complex * z1)¶ This function finds the complex roots of the quadratic equation,
The number of complex roots is returned (either one or two) and the locations of the roots are stored in
z0
andz1
. The roots are returned in ascending order, sorted first by their real components and then by their imaginary components. If only one real root is found (i.e. if ) then it is stored inz0
.
Cubic Equations¶

int
gsl_poly_solve_cubic
(double a, double b, double c, double * x0, double * x1, double * x2)¶ This function finds the real roots of the cubic equation,
with a leading coefficient of unity. The number of real roots (either one or three) is returned, and their locations are stored in
x0
,x1
andx2
. If one real root is found then onlyx0
is modified. When three real roots are found they are stored inx0
,x1
andx2
in ascending order. The case of coincident roots is not considered special. For example, the equation will have three roots with exactly equal values. As in the quadratic case, finite precision may cause equal or closelyspaced real roots to move off the real axis into the complex plane, leading to a discrete change in the number of real roots.

int
gsl_poly_complex_solve_cubic
(double a, double b, double c, gsl_complex * z0, gsl_complex * z1, gsl_complex * z2)¶ This function finds the complex roots of the cubic equation,
The number of complex roots is returned (always three) and the locations of the roots are stored in
z0
,z1
andz2
. The roots are returned in ascending order, sorted first by their real components and then by their imaginary components.
General Polynomial Equations¶
The roots of polynomial equations cannot be found analytically beyond the special cases of the quadratic, cubic and quartic equation. The algorithm described in this section uses an iterative method to find the approximate locations of roots of higher order polynomials.

gsl_poly_complex_workspace
¶ This workspace contains parameters used for finding roots of general polynomials

gsl_poly_complex_workspace *
gsl_poly_complex_workspace_alloc
(size_t n)¶ This function allocates space for a
gsl_poly_complex_workspace
struct and a workspace suitable for solving a polynomial withn
coefficients using the routinegsl_poly_complex_solve()
.The function returns a pointer to the newly allocated
gsl_poly_complex_workspace
if no errors were detected, and a null pointer in the case of error.

void
gsl_poly_complex_workspace_free
(gsl_poly_complex_workspace * w)¶ This function frees all the memory associated with the workspace
w
.

int
gsl_poly_complex_solve
(const double * a, size_t n, gsl_poly_complex_workspace * w, gsl_complex_packed_ptr z)¶ This function computes the roots of the general polynomial
using balancedQR reduction of the companion matrix. The parameter
n
specifies the length of the coefficient array. The coefficient of the highest order term must be nonzero. The function requires a workspacew
of the appropriate size. The roots are returned in the packed complex arrayz
of length , alternating real and imaginary parts.The function returns
GSL_SUCCESS
if all the roots are found. If the QR reduction does not converge, the error handler is invoked with an error code ofGSL_EFAILED
. Note that due to finite precision, roots of higher multiplicity are returned as a cluster of simple roots with reduced accuracy. The solution of polynomials with higherorder roots requires specialized algorithms that take the multiplicity structure into account (see e.g. Z. Zeng, Algorithm 835, ACM Transactions on Mathematical Software, Volume 30, Issue 2 (2004), pp 218–236).
Examples¶
To demonstrate the use of the general polynomial solver we will take the polynomial which has these roots:
The following program will find these roots.
#include <stdio.h>
#include <gsl/gsl_poly.h>
int
main (void)
{
int i;
/* coefficients of P(x) = 1 + x^5 */
double a[6] = { 1, 0, 0, 0, 0, 1 };
double z[10];
gsl_poly_complex_workspace * w
= gsl_poly_complex_workspace_alloc (6);
gsl_poly_complex_solve (a, 6, w, z);
gsl_poly_complex_workspace_free (w);
for (i = 0; i < 5; i++)
{
printf ("z%d = %+.18f %+.18f\n",
i, z[2*i], z[2*i+1]);
}
return 0;
}
The output of the program is
z0 = 0.809016994374947673 +0.587785252292473359
z1 = 0.809016994374947673 0.587785252292473359
z2 = +0.309016994374947507 +0.951056516295152976
z3 = +0.309016994374947507 0.951056516295152976
z4 = +0.999999999999999889 +0.000000000000000000
which agrees with the analytic result, .
References and Further Reading¶
The balancedQR method and its error analysis are described in the following papers,
 R.S. Martin, G. Peters and J.H. Wilkinson, “The QR Algorithm for Real Hessenberg Matrices”, Numerische Mathematik, 14 (1970), 219–231.
 B.N. Parlett and C. Reinsch, “Balancing a Matrix for Calculation of Eigenvalues and Eigenvectors”, Numerische Mathematik, 13 (1969), 293–304.
 A. Edelman and H. Murakami, “Polynomial roots from companion matrix eigenvalues”, Mathematics of Computation, Vol.: 64, No.: 210 (1995), 763–776.
The formulas for divided differences are given in the following texts,
 Abramowitz and Stegun, Handbook of Mathematical Functions, Sections 25.1.4 and 25.2.26.
 R. L. Burden and J. D. Faires, Numerical Analysis, 9th edition, ISBN 0538733519, 2011.