Core 1.0
Nonic Class Reference

Nonic polynomials. More...

#include <nonic.h>

Public Member Functions

 Nonic ()
 Empty.
 Nonic (const double &, const double &, const double &, const double &, const double &, const double &, const double &, const double &, const double &, const double &)
 Creates a Nonic polynomial.
 Nonic (const Octic &)
 Creates a nonic given an octic. The degree-9 coefficient is set to zero.
 Nonic (const Septic &)
 Creates a nonic given a septic. Higher coefficients are set to zero.
 Nonic (const Sextic &)
 Creates a nonic given a sextic. Higher coefficients are set to zero.
 Nonic (const Quintic &)
 Creates a nonic given a quintic. Higher coefficients are set to zero.
 Nonic (const Quartic &)
 Creates a nonic given a quartic. Higher coefficients are set to zero.
 Nonic (const Cubic &)
 Creates a nonic given a cubic. Higher coefficients are set to zero.
 Nonic (const Quadric &)
 Creates a nonic given a quadric. Higher coefficients are set to zero.
 ~Nonic ()
 Empty.
constexpr double & operator[] (int)
 Access to the coefficients of the nonic.
constexpr double operator[] (int) const
 Overloaded.
int CheckDegree () const
 Check the degree of the Nonic.
Nonic operator- () const
 Unary.
Nonic & operator+= (const Nonic &)
 Destructive sum of two Nonics.
Nonic & operator-= (const Nonic &)
 Destructive difference of two Nonics.
Nonic & operator*= (const double &)
 Scale a Nonic by a double value.
Nonic & operator/= (const double &)
 Scale a Nonic by a double value.
int Solve (double *) const
 Solve the nonic equation.
int Solve (double *, const double &, const double &) const
 Search the roots of a nonic equation within a given interval.
Octic Prime () const
 Computes the first derivative of a nonic, which is an octic.
Septic Second () const
 Computes the second derivative of a Nonic.
Sextic Third () const
 Computes the third derivative of a Nonic.
constexpr double operator() (const double &) const
 Evaluates the Nonic.
constexpr double Derivative (const double &) const
 Computes the derivative of the nonic.

Static Public Member Functions

static Nonic Compose (const Cubic &, const Cubic &)
 Compose two cubic polynomials into a nonic.
static double Smooth (const double &)
 Compute the value of smooth \( C^4 \) interpolating function over unit interval.
static double SmoothStep (const double &, const double &, const double &)
 Compute a Nonic smooth step.
static double Gaussian (const double &, const double &, const double &)
 Compute a compactly supported Gaussian-like pulse.

Static Public Attributes

static const double epsilon = 1.0e-10
 Epsilon value used to check discriminant terms in the root finding process.

Protected Attributes

double c [10] = { 0.0 }
 Array of coefficients.

Friends

Nonic operator+ (const Nonic &u, const Nonic &v)
 Overloaded.
Nonic operator- (const Nonic &v, const Nonic &u)
 Overloaded.
Nonic operator* (const Nonic &u, const double &e)
 Overloaded.
Nonic operator* (const double &a, const Nonic &p)
 Overloaded.
Nonic operator/ (const Nonic &p, const double &a)
 Overloaded.
std::ostream & operator<< (std::ostream &s, const Nonic &p)
 Overloaded output-stream operator.

Detailed Description

Nonic polynomials.

Constructors should provide the coefficients in descending order. Example of how to code the Nonic \( 19x^9 - x + 1 \):

Nonic p(19.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,-1.0,1.0);
Nonic()
Empty.
Definition nonic.h:12

Constructor & Destructor Documentation

◆ Nonic() [1/7]

Nonic::Nonic ( const Octic & p)
inline

Creates a nonic given an octic. The degree-9 coefficient is set to zero.

Parameters
pOctic.

◆ Nonic() [2/7]

Nonic::Nonic ( const Septic & p)
inline

Creates a nonic given a septic. Higher coefficients are set to zero.

Parameters
pSeptic.

◆ Nonic() [3/7]

Nonic::Nonic ( const Sextic & p)
inline

Creates a nonic given a sextic. Higher coefficients are set to zero.

Parameters
pSextic.

◆ Nonic() [4/7]

Nonic::Nonic ( const Quintic & p)
inline

Creates a nonic given a quintic. Higher coefficients are set to zero.

Parameters
pQuintic.

◆ Nonic() [5/7]

Nonic::Nonic ( const Quartic & p)
inline

Creates a nonic given a quartic. Higher coefficients are set to zero.

Parameters
pQuartic.

◆ Nonic() [6/7]

Nonic::Nonic ( const Cubic & p)
inline

Creates a nonic given a cubic. Higher coefficients are set to zero.

Parameters
pCubic.

◆ Nonic() [7/7]

Nonic::Nonic ( const Quadric & p)
inline

Creates a nonic given a quadric. Higher coefficients are set to zero.

Parameters
pQuadric.

Member Function Documentation

◆ Compose()

Nonic Nonic::Compose ( const Cubic & p,
const Cubic & q )
static

Compose two cubic polynomials into a nonic.

This function computes p(q(x)), where p is the outer cubic and q the inner cubic.

Parameters
pThe outer cubic polynomial.
qThe inner cubic polynomial (argument).

◆ Derivative()

double Nonic::Derivative ( const double & x) const
inlineconstexpr

Computes the derivative of the nonic.

This function is more efficient than using Prime() and then evaluating the derivative for a given input value.

Parameters
xReal.

◆ Gaussian()

double Nonic::Gaussian ( const double & c,
const double & r,
const double & x )
inlinestatic

Compute a compactly supported Gaussian-like pulse.

The function has \( C^4 \) continuity.

See also
Cubic::Gaussian(), Quintic::Gaussian() and Septic::Gaussian()
Parameters
cCenter.
rRadius.
xValue.

◆ operator()()

double Nonic::operator() ( const double & x) const
inlineconstexpr

Evaluates the Nonic.

Parameters
xArgument value of the function.

◆ Smooth()

double Nonic::Smooth ( const double & x)
inlinestatic

Compute the value of smooth \( C^4 \) interpolating function over unit interval.

The Nonic is defined as \( x^5 (70 x^4 - 315 x^3 + 540 x^2 - 420 x + 126) \). Its first four derivatives at 0.0 and 1.0 are 0.0.

The Lipschitz constant of the smooth nonic over [0,1] is \( \lambda = 315/128 \).

Parameters
xArgument in [0,1].
See also
Septic::Smooth(), Quintic::Smooth(), Cubic::Smooth()

◆ SmoothStep()

double Nonic::SmoothStep ( const double & x,
const double & a,
const double & b )
inlinestatic

Compute a Nonic smooth step.

The code is slightly more efficient than:

double y=Nonic::Smooth(Linear::Step(x,a,b));
static double Step(const double &, const double &, const double &)
Create a linear step.
Definition linear.h:195
static double Smooth(const double &)
Compute the value of smooth interpolating function over unit interval.
Definition nonic.h:218
Parameters
xInput value.
a,bInterval values.
See also
Septic::SmoothStep(), Cubic::SmoothStep(), Quintic::SmoothStep()

◆ Solve() [1/2]

int Nonic::Solve ( double * roots) const

Solve the nonic equation.

Parameters
rootsRoots.

◆ Solve() [2/2]

int Nonic::Solve ( double * roots,
const double & a,
const double & b ) const

Search the roots of a nonic equation within a given interval.

Parameters
rootsArray for storing the roots.
a,bInterval range.

◆ operator<<

std::ostream & operator<< ( std::ostream & s,
const Nonic & p )
friend

Overloaded output-stream operator.

Parameters
sStream.
pThe Nonic.