USGS

Isis 3.0 Object Programmers' Reference

Home

Isis::PolynomialUnivariate Class Reference

Nth degree Polynomial with one variable. More...

#include <PolynomialUnivariate.h>

Inheritance diagram for Isis::PolynomialUnivariate:
Inheritance graph
Collaboration diagram for Isis::PolynomialUnivariate:
Collaboration graph

Public Member Functions

 PolynomialUnivariate (int degree)
 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.
 
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.

Definition at line 52 of file PolynomialUnivariate.h.

Constructor & Destructor Documentation

Isis::PolynomialUnivariate::PolynomialUnivariate ( int  degree)

Create a PolynomialUnivariate object.

Parameters
degreeThe order/degree of the polynomial

Definition at line 37 of file PolynomialUnivariate.cpp.

References p_degree.

Isis::PolynomialUnivariate::~PolynomialUnivariate ( )
inline

Destroys the PolynomialUnivariate object.

Definition at line 57 of file PolynomialUnivariate.h.

Member Function Documentation

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

Returns the ith coefficient.

Parameters
iThe index for the desired coefficient.
Returns
The ith coefficient

Definition at line 119 of file BasisFunction.h.

References Isis::BasisFunction::p_coefs.

Referenced by DerivativeVar(), Isis::SpicePosition::LoadHermiteCache(), Isis::SurfaceModel::MinMax(), Isis::SpicePosition::SetPolynomial(), Isis::SpiceRotation::SetPolynomial(), Isis::Affine::Solve(), and Isis::BundleAdjust::Update().

int Isis::BasisFunction::Coefficients ( ) const
inlineinherited

Returns the number of coefficients for the equation.

Returns
The number of coefficients.

Definition at line 76 of file BasisFunction.h.

References Isis::BasisFunction::p_numCoefs.

Referenced by DerivativeCoef(), DerivativeVar(), Isis::SpicePosition::SetPolynomial(), Isis::SpiceRotation::SetPolynomial(), Isis::LeastSquares::SolveQRD(), and Isis::LeastSquares::SolveSVD().

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 91 of file PolynomialUnivariate.cpp.

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

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 68 of file PolynomialUnivariate.cpp.

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

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

Compute the equation using the input variables.

Parameters
varsA 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 74 of file BasisFunction.cpp.

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

Referenced by Isis::LeastSquares::Evaluate(), Isis::SpicePosition::LoadHermiteCache(), Isis::SpicePosition::SetEphemerisTimePolyFunction(), Isis::LeastSquares::SolveQRD(), and Isis::LeastSquares::SolveSVD().

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
varsA vector of double values to use for the expansion.

Reimplemented from Isis::BasisFunction.

Definition at line 49 of file PolynomialUnivariate.cpp.

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

QString Isis::BasisFunction::Name ( ) const
inlineinherited

Returns the name of the equation.

Returns
The name of the equation.

Definition at line 92 of file BasisFunction.h.

References Isis::BasisFunction::p_name.

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

void Isis::BasisFunction::SetCoefficients ( const std::vector< double > &  coefs)
inherited
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
cThe index for the desired coefficient.
Returns
The cth term.

Definition at line 109 of file BasisFunction.h.

References Isis::BasisFunction::p_terms.

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

int Isis::BasisFunction::Variables ( ) const
inlineinherited

Returns the number of variables in the equation.

Returns
The number of variables.

Definition at line 84 of file BasisFunction.h.

References Isis::BasisFunction::p_numVars.

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

Member Data Documentation

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

A vector of the coefficients in the equation.

Call it by using Coefficient()

Definition at line 135 of file BasisFunction.h.

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

int Isis::PolynomialUnivariate::p_degree
private

The order/degree of the polynomial.

Definition at line 65 of file PolynomialUnivariate.h.

Referenced by Expand(), and PolynomialUnivariate().

QString Isis::BasisFunction::p_name
protectedinherited

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

Definition at line 121 of file BasisFunction.h.

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

int Isis::BasisFunction::p_numCoefs
protectedinherited

The number of coefficients in the equation.

Call it by using Coefficients()

Definition at line 131 of file BasisFunction.h.

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

int Isis::BasisFunction::p_numVars
protectedinherited

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

Definition at line 127 of file BasisFunction.h.

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

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

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