Nth degree Polynomial with one variable. More...

#include <PolynomialUnivariate.h>

Inheritance diagram for Isis::PolynomialUnivariate:

Collaboration diagram for Isis::PolynomialUnivariate:

Public Member Functions
	PolynomialUnivariate (int degree)
	Create a PolynomialUnivariate object.

	PolynomialUnivariate (int degree, std::vector< double > coeffs)
	Create a PolynomialUnivariate object.

	~PolynomialUnivariate ()
	Destroys the PolynomialUnivariate object.

void	Expand (const std::vector< double > &vars)
	This is the the overriding virtual function that provides the expansion of the two input variables into the polynomial equation.

double	DerivativeVar (const double value)
	This will take the Derivative with respect to the variable and evaluate at given value.

double	DerivativeCoef (const double value, const int coefIndex)
	Evaluate the derivative of the polynomial defined by the given coefficients with respect to the coefficient at the given index, at the current value.

void	SetCoefficients (const std::vector< double > &coefs)
	Set the coefficients for the equation.

double	Evaluate (const std::vector< double > &vars)
	Compute the equation using the input variables.

double	Evaluate (const double &var)
	Compute the equation using the input variable.

int	Coefficients () const
	Returns the number of coefficients for the equation.

int	Variables () const
	Returns the number of variables in the equation.

QString	Name () const
	Returns the name of the equation.

double	Term (int c) const
	Returns the cth term.

double	Coefficient (int i) const
	Returns the ith coefficient.

Protected Attributes
QString	p_name
	The name of the equation. Call it by using Name()

int	p_numVars
	The number of variables in the equation. Call it by using Variables()

int	p_numCoefs
	The number of coefficients in the equation.

std::vector< double >	p_coefs
	A vector of the coefficients in the equation.

std::vector< double >	p_terms
	A vector of the terms in the equation.

Private Attributes
int	p_degree
	The order/degree of the polynomial.

Detailed Description

Nth degree Polynomial with one variable.

This is a derived class from Basis1VariableFunction which provides the capabilities of a polynomial equation in one variable with degree n, where n is specified during the object construction. For example, Degree = 1 z = a + b*x Degree = 2 z = a + b*x + c*x**2 Degree = 3 z = a + b*x + c*x**2 + d*x**3 In general the number of coefficients will be degree + 1.

Author: Debbie A. Cook 2007-11-19 (modified from Poly2D, now named PolynominalBivariate, 2004-06-24 Jeff Anderson)

History

2008-01-11 Tracie Sucharski - Renamed from Poly1D, add derivative methods.

2008-02-05 Jeannie Walldren - Renamed from Polynomial1Variable.

2015-02-20 Jeannie Backer - Improved error messages.

2016-11-10 Kristin Berry - Added additional convenience constructor which accepts a vector of coeffs. References #3888.

Definition at line 37 of file PolynomialUnivariate.h.

Constructor & Destructor Documentation

◆ PolynomialUnivariate() [1/2]

Isis::PolynomialUnivariate::PolynomialUnivariate ( int degree )

Create a PolynomialUnivariate object.

Parameters

degree The order/degree of the polynomial

Definition at line 21 of file PolynomialUnivariate.cpp.

References p_degree.

◆ PolynomialUnivariate() [2/2]

Isis::PolynomialUnivariate::PolynomialUnivariate	(	int	degree,
		std::vector< double >	coeffs )

Create a PolynomialUnivariate object.

Parameters

degree	The order/degree of the polynomial
coeffs	a list of the coefficients in increasing degree. So the first element is the constant coefficient.

Definition at line 34 of file PolynomialUnivariate.cpp.

References p_degree, and Isis::BasisFunction::SetCoefficients().

◆ ~PolynomialUnivariate()

Isis::PolynomialUnivariate::~PolynomialUnivariate ( )

inline

Destroys the PolynomialUnivariate object.

Definition at line 43 of file PolynomialUnivariate.h.

Member Function Documentation

◆ Coefficient()

double Isis::BasisFunction::Coefficient ( int i ) const

inlineinherited

Returns the ith coefficient.

Parameters

i	The index for the desired coefficient.

Returns: The ith coefficient

Definition at line 107 of file BasisFunction.h.

References Isis::BasisFunction::p_coefs.

Referenced by DerivativeVar(), Isis::SurfaceModel::MinMax(), and Isis::OverlapNormalization::Solve().

◆ Coefficients()

int Isis::BasisFunction::Coefficients ( ) const

inlineinherited

Returns the number of coefficients for the equation.

Returns: The number of coefficients.

Definition at line 64 of file BasisFunction.h.

References Isis::BasisFunction::p_numCoefs.

Referenced by DerivativeCoef(), DerivativeVar(), Isis::OverlapNormalization::Solve(), Isis::LeastSquares::SolveQRD(), and Isis::LeastSquares::SolveSVD().

◆ DerivativeCoef()

double Isis::PolynomialUnivariate::DerivativeCoef	(	const double	value,
		const int	coefIndex )

virtual

Evaluate the derivative of the polynomial defined by the given coefficients with respect to the coefficient at the given index, at the current value.

Parameters

[in]	value	(const double) value at which to evaluate derivative
[in]	coefIndex	(const int) The index of the coefficient to differentiate with respect to

Returns: (double) The derivative evaluated at given value

Implements Isis::Basis1VariableFunction.

Definition at line 90 of file PolynomialUnivariate.cpp.

References Isis::BasisFunction::Coefficients(), Isis::IException::Programmer, and Isis::toString().

◆ DerivativeVar()

double Isis::PolynomialUnivariate::DerivativeVar ( const double value )

virtual

This will take the Derivative with respect to the variable and evaluate at given value.

Parameters

[in] value (const double) value at which to evaluate derivative

History: 2008-01-09 Tracie Sucharski, Original Version

Implements Isis::Basis1VariableFunction.

Definition at line 67 of file PolynomialUnivariate.cpp.

References Isis::BasisFunction::Coefficient(), and Isis::BasisFunction::Coefficients().

Referenced by Isis::SpiceRotation::DCJdt().

◆ Evaluate() [1/2]

double Isis::BasisFunction::Evaluate ( const double & var )

inherited

Compute the equation using the input variable.

Parameters

var	A single double value to use for the equation.

Returns: The output double value resulting from the equation.

Definition at line 101 of file BasisFunction.cpp.

References Isis::BasisFunction::Evaluate().

◆ Evaluate() [2/2]

double Isis::BasisFunction::Evaluate ( const std::vector< double > & vars )

inherited

Compute the equation using the input variables.

Parameters

vars	A vector of double values to use for the equation. After setting the coefficients, this can be invoked many times to compute output values given input values.

Returns: The output value.

Definition at line 64 of file BasisFunction.cpp.

References Isis::BasisFunction::Expand(), Isis::BasisFunction::p_coefs, Isis::BasisFunction::p_numCoefs, Isis::BasisFunction::p_numVars, Isis::BasisFunction::p_terms, Isis::IException::Programmer, and Isis::toString().

Referenced by Isis::BasisFunction::Evaluate(), Isis::LeastSquares::Evaluate(), Isis::LeastSquares::SolveQRD(), and Isis::LeastSquares::SolveSVD().

◆ Expand()

void Isis::PolynomialUnivariate::Expand ( const std::vector< double > & vars )

virtual

This is the the overriding virtual function that provides the expansion of the two input variables into the polynomial equation.

See BasisFunction for more information.

Parameters

vars	A vector of double values to use for the expansion.

Reimplemented from Isis::BasisFunction.

Definition at line 48 of file PolynomialUnivariate.cpp.

References p_degree, and Isis::BasisFunction::p_terms.

◆ Name()

QString Isis::BasisFunction::Name ( ) const

inlineinherited

Returns the name of the equation.

Returns: The name of the equation.

Definition at line 80 of file BasisFunction.h.

References Isis::BasisFunction::p_name.

Referenced by Isis::LeastSquares::AddKnown().

◆ SetCoefficients()

void Isis::BasisFunction::SetCoefficients ( const std::vector< double > & coefs )

inherited

Set the coefficients for the equation.

Parameters

coefs A vector of coefficients for the equation.

Definition at line 42 of file BasisFunction.cpp.

References Isis::BasisFunction::p_coefs, Isis::BasisFunction::p_numCoefs, Isis::IException::Programmer, and Isis::toString().

Referenced by Isis::SpiceRotation::DCJdt(), PolynomialUnivariate(), Isis::LeastSquares::SolveQRD(), Isis::LeastSquares::SolveSparse(), and Isis::LeastSquares::SolveSVD().

◆ Term()

double Isis::BasisFunction::Term ( int c ) const

inlineinherited

Returns the cth term.

This is only valid after a Evalute/Expand has been invoked. It represents the expansion of the variables into the ith term. For example,

\[ x = C1 + C2*x + C3*y + C4*x*y \]

would return x*y for the 3rd term (zero-based)

Parameters

c	The index for the desired coefficient.

Returns: The cth term.

Definition at line 97 of file BasisFunction.h.

References Isis::BasisFunction::p_terms.

Referenced by Isis::LeastSquares::FillSparseA(), Isis::LeastSquares::SolveQRD(), and Isis::LeastSquares::SolveSVD().

◆ Variables()

int Isis::BasisFunction::Variables ( ) const

inlineinherited

Returns the number of variables in the equation.

Returns: The number of variables.

Definition at line 72 of file BasisFunction.h.

References Isis::BasisFunction::p_numVars.

Referenced by Isis::LeastSquares::AddKnown(), and Isis::NthOrderPolynomial::Expand().

Member Data Documentation

◆ p_coefs

std::vector<double> Isis::BasisFunction::p_coefs

protectedinherited

A vector of the coefficients in the equation.

Call it by using Coefficient()

Definition at line 123 of file BasisFunction.h.

Referenced by Isis::BasisFunction::Coefficient(), Isis::BasisFunction::Evaluate(), and Isis::BasisFunction::SetCoefficients().

◆ p_degree

int Isis::PolynomialUnivariate::p_degree

private

The order/degree of the polynomial.

Definition at line 51 of file PolynomialUnivariate.h.

Referenced by Expand(), PolynomialUnivariate(), and PolynomialUnivariate().

◆ p_name

QString Isis::BasisFunction::p_name

protectedinherited

The name of the equation. Call it by using Name()

Definition at line 113 of file BasisFunction.h.

Referenced by Isis::BasisFunction::BasisFunction(), and Isis::BasisFunction::Name().

◆ p_numCoefs

int Isis::BasisFunction::p_numCoefs

protectedinherited

The number of coefficients in the equation.

Call it by using Coefficients()

Definition at line 119 of file BasisFunction.h.

Referenced by Isis::BasisFunction::BasisFunction(), Isis::BasisFunction::Coefficients(), Isis::BasisFunction::Evaluate(), and Isis::BasisFunction::SetCoefficients().

◆ p_numVars

int Isis::BasisFunction::p_numVars

protectedinherited

The number of variables in the equation. Call it by using Variables()

Definition at line 115 of file BasisFunction.h.

Referenced by Isis::BasisFunction::BasisFunction(), Isis::BasisFunction::Evaluate(), and Isis::BasisFunction::Variables().

◆ p_terms

std::vector<double> Isis::BasisFunction::p_terms

protectedinherited

A vector of the terms in the equation.

Call it by using Term()

Definition at line 127 of file BasisFunction.h.

Referenced by Isis::BasisFunction::Evaluate(), Isis::BasisFunction::Expand(), Isis::NthOrderPolynomial::Expand(), Isis::PolynomialBivariate::Expand(), Expand(), and Isis::BasisFunction::Term().

The documentation for this class was generated from the following files:

src/base/objs/PolynomialUnivariate/PolynomialUnivariate.h
src/base/objs/PolynomialUnivariate/PolynomialUnivariate.cpp

Public Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PolynomialUnivariate() [1/2]

◆ PolynomialUnivariate() [2/2]

◆ ~PolynomialUnivariate()

Member Function Documentation

◆ Coefficient()

◆ Coefficients()

◆ DerivativeCoef()

◆ DerivativeVar()

◆ Evaluate() [1/2]

◆ Evaluate() [2/2]

◆ Expand()

◆ Name()

◆ SetCoefficients()

◆ Term()

◆ Variables()

Member Data Documentation

◆ p_coefs

◆ p_degree

◆ p_name

◆ p_numCoefs

◆ p_numVars

◆ p_terms