AppDef_TheLeastSquares Class Reference

`#include <AppDef_TheLeastSquares.hxx>`

## Public Member Functions

AppDef_TheLeastSquares (const AppDef_MultiLine &SSP, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const math_Vector &Parameters, const Standard_Integer NbPol)
given a MultiLine, this algorithm computes the least square resolution using the Householder-QR method. If the first and/or the last point is a constraint point, the value of the tangency or curvature is computed in the resolution. NbPol is the number of control points wanted for the approximating curves. The system to solve is the following: A X = B. Where A is the Bernstein matrix computed with the parameters, B the points coordinates and X the poles solutions. The matrix A is the same for each coordinate x, y and z and is also the same for each MultiLine point because they are approximated in parallel(so with the same parameter, only the vector B changes). More...

AppDef_TheLeastSquares (const AppDef_MultiLine &SSP, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const Standard_Integer NbPol)
Initializes the fields of the object. More...

AppDef_TheLeastSquares (const AppDef_MultiLine &SSP, const TColStd_Array1OfReal &Knots, const TColStd_Array1OfInteger &Mults, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const math_Vector &Parameters, const Standard_Integer NbPol)
given a MultiLine, this algorithm computes the least square resolution using the Householder-QR method. If the first and/or the last point is a constraint point, the value of the tangency or curvature is computed in the resolution. Deg is the degree wanted for the approximating curves. The system to solve is the following: A X = B. Where A is the BSpline functions matrix computed with <parameters>, B the points coordinates and X the poles solutions. The matrix A is the same for each coordinate x, y and z and is also the same for each MultiLine point because they are approximated in parallel(so with the same parameter, only the vector B changes). More...

AppDef_TheLeastSquares (const AppDef_MultiLine &SSP, const TColStd_Array1OfReal &Knots, const TColStd_Array1OfInteger &Mults, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const Standard_Integer NbPol)
Initializes the fields of the object. More...

void Perform (const math_Vector &Parameters)
Is used after having initialized the fields. The case "CurvaturePoint" is not treated in this method. More...

void Perform (const math_Vector &Parameters, const Standard_Real l1, const Standard_Real l2)
Is used after having initialized the fields. More...

void Perform (const math_Vector &Parameters, const math_Vector &V1t, const math_Vector &V2t, const Standard_Real l1, const Standard_Real l2)
Is used after having initialized the fields. <V1t> is the tangent vector at the first point. <V2t> is the tangent vector at the last point. More...

void Perform (const math_Vector &Parameters, const math_Vector &V1t, const math_Vector &V2t, const math_Vector &V1c, const math_Vector &V2c, const Standard_Real l1, const Standard_Real l2)
Is used after having initialized the fields. <V1t> is the tangent vector at the first point. <V2t> is the tangent vector at the last point. <V1c> is the tangent vector at the first point. <V2c> is the tangent vector at the last point. More...

Standard_Boolean IsDone () const
returns True if all has been correctly done. More...

AppParCurves_MultiCurve BezierValue ()
returns the result of the approximation, i.e. all the Curves. An exception is raised if NotDone. More...

const AppParCurves_MultiBSpCurveBSplineValue ()
returns the result of the approximation, i.e. all the Curves. An exception is raised if NotDone. More...

const math_MatrixFunctionMatrix () const
returns the function matrix used to approximate the set. More...

const math_MatrixDerivativeFunctionMatrix () const
returns the derivative function matrix used to approximate the set. More...

returns the maximum errors between the MultiLine and the approximation curves. F is the sum of the square distances. Grad is the derivative vector of the function F. More...

const math_MatrixDistance ()
returns the distances between the points of the multiline and the approximation curves. More...

void Error (Standard_Real &F, Standard_Real &MaxE3d, Standard_Real &MaxE2d)
returns the maximum errors between the MultiLine and the approximation curves. F is the sum of the square distances. More...

Standard_Real FirstLambda () const
returns the value (P2 - P1)/ V1 if the first point was a tangency point. More...

Standard_Real LastLambda () const
returns the value (PN - PN-1)/ VN if the last point was a tangency point. More...

const math_MatrixPoints () const
returns the matrix of points value. More...

const math_MatrixPoles () const
returns the matrix of resulting control points value. More...

const math_IntegerVectorKIndex () const
Returns the indexes of the first non null values of A and DA. The values are non null from Index(ieme point) +1 to Index(ieme point) + degree +1. More...

## Protected Member Functions

void Init (const AppDef_MultiLine &SSP, const Standard_Integer FirstPoint, const Standard_Integer LastPoint)
is used by the constuctors above. More...

Standard_Integer NbBColumns (const AppDef_MultiLine &SSP) const
returns the number of second member columns. Is used internally to initialize the fields. More...

Standard_Integer TheFirstPoint (const AppParCurves_Constraint FirstCons, const Standard_Integer FirstPoint) const
returns the first point beeing fitted. More...

Standard_Integer TheLastPoint (const AppParCurves_Constraint LastCons, const Standard_Integer LastPoint) const
returns the last point beeing fitted. More...

void Affect (const AppDef_MultiLine &SSP, const Standard_Integer Index, AppParCurves_Constraint &Cons, math_Vector &Vt, math_Vector &Vc)
Affects the fields in the case of a constraint point. More...

void ComputeFunction (const math_Vector &Parameters)

void SearchIndex (math_IntegerVector &Index)

void MakeTAA (math_Vector &TheA, math_Vector &TheB)
computes internal matrixes for the resolution More...

void MakeTAA (math_Vector &TheA)
computes internal matrixes for the resolution More...

void MakeTAA (math_Vector &TheA, math_Matrix &TheB)
computes internal matrixes for the resolution More...

## Constructor & Destructor Documentation

 AppDef_TheLeastSquares::AppDef_TheLeastSquares ( const AppDef_MultiLine & SSP, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const math_Vector & Parameters, const Standard_Integer NbPol )

given a MultiLine, this algorithm computes the least square resolution using the Householder-QR method. If the first and/or the last point is a constraint point, the value of the tangency or curvature is computed in the resolution. NbPol is the number of control points wanted for the approximating curves. The system to solve is the following: A X = B. Where A is the Bernstein matrix computed with the parameters, B the points coordinates and X the poles solutions. The matrix A is the same for each coordinate x, y and z and is also the same for each MultiLine point because they are approximated in parallel(so with the same parameter, only the vector B changes).

 AppDef_TheLeastSquares::AppDef_TheLeastSquares ( const AppDef_MultiLine & SSP, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const Standard_Integer NbPol )

Initializes the fields of the object.

 AppDef_TheLeastSquares::AppDef_TheLeastSquares ( const AppDef_MultiLine & SSP, const TColStd_Array1OfReal & Knots, const TColStd_Array1OfInteger & Mults, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const math_Vector & Parameters, const Standard_Integer NbPol )

given a MultiLine, this algorithm computes the least square resolution using the Householder-QR method. If the first and/or the last point is a constraint point, the value of the tangency or curvature is computed in the resolution. Deg is the degree wanted for the approximating curves. The system to solve is the following: A X = B. Where A is the BSpline functions matrix computed with <parameters>, B the points coordinates and X the poles solutions. The matrix A is the same for each coordinate x, y and z and is also the same for each MultiLine point because they are approximated in parallel(so with the same parameter, only the vector B changes).

 AppDef_TheLeastSquares::AppDef_TheLeastSquares ( const AppDef_MultiLine & SSP, const TColStd_Array1OfReal & Knots, const TColStd_Array1OfInteger & Mults, const Standard_Integer FirstPoint, const Standard_Integer LastPoint, const AppParCurves_Constraint FirstCons, const AppParCurves_Constraint LastCons, const Standard_Integer NbPol )

Initializes the fields of the object.

## Member Function Documentation

 void AppDef_TheLeastSquares::Affect ( const AppDef_MultiLine & SSP, const Standard_Integer Index, AppParCurves_Constraint & Cons, math_Vector & Vt, math_Vector & Vc )
protected

Affects the fields in the case of a constraint point.

 AppParCurves_MultiCurve AppDef_TheLeastSquares::BezierValue ( )

returns the result of the approximation, i.e. all the Curves. An exception is raised if NotDone.

 const AppParCurves_MultiBSpCurve& AppDef_TheLeastSquares::BSplineValue ( )

returns the result of the approximation, i.e. all the Curves. An exception is raised if NotDone.

 void AppDef_TheLeastSquares::ComputeFunction ( const math_Vector & Parameters )
protected
 const math_Matrix& AppDef_TheLeastSquares::DerivativeFunctionMatrix ( ) const

returns the derivative function matrix used to approximate the set.

 const math_Matrix& AppDef_TheLeastSquares::Distance ( )

returns the distances between the points of the multiline and the approximation curves.

 void AppDef_TheLeastSquares::Error ( Standard_Real & F, Standard_Real & MaxE3d, Standard_Real & MaxE2d )

returns the maximum errors between the MultiLine and the approximation curves. F is the sum of the square distances.

 void AppDef_TheLeastSquares::ErrorGradient ( math_Vector & Grad, Standard_Real & F, Standard_Real & MaxE3d, Standard_Real & MaxE2d )

returns the maximum errors between the MultiLine and the approximation curves. F is the sum of the square distances. Grad is the derivative vector of the function F.

 Standard_Real AppDef_TheLeastSquares::FirstLambda ( ) const

returns the value (P2 - P1)/ V1 if the first point was a tangency point.

 const math_Matrix& AppDef_TheLeastSquares::FunctionMatrix ( ) const

returns the function matrix used to approximate the set.

 void AppDef_TheLeastSquares::Init ( const AppDef_MultiLine & SSP, const Standard_Integer FirstPoint, const Standard_Integer LastPoint )
protected

is used by the constuctors above.

 Standard_Boolean AppDef_TheLeastSquares::IsDone ( ) const

returns True if all has been correctly done.

 const math_IntegerVector& AppDef_TheLeastSquares::KIndex ( ) const

Returns the indexes of the first non null values of A and DA. The values are non null from Index(ieme point) +1 to Index(ieme point) + degree +1.

 Standard_Real AppDef_TheLeastSquares::LastLambda ( ) const

returns the value (PN - PN-1)/ VN if the last point was a tangency point.

 void AppDef_TheLeastSquares::MakeTAA ( math_Vector & TheA, math_Vector & TheB )
protected

computes internal matrixes for the resolution

 void AppDef_TheLeastSquares::MakeTAA ( math_Vector & TheA )
protected

computes internal matrixes for the resolution

 void AppDef_TheLeastSquares::MakeTAA ( math_Vector & TheA, math_Matrix & TheB )
protected

computes internal matrixes for the resolution

 Standard_Integer AppDef_TheLeastSquares::NbBColumns ( const AppDef_MultiLine & SSP ) const
protected

returns the number of second member columns. Is used internally to initialize the fields.

 void AppDef_TheLeastSquares::Perform ( const math_Vector & Parameters )

Is used after having initialized the fields. The case "CurvaturePoint" is not treated in this method.

 void AppDef_TheLeastSquares::Perform ( const math_Vector & Parameters, const Standard_Real l1, const Standard_Real l2 )

Is used after having initialized the fields.

 void AppDef_TheLeastSquares::Perform ( const math_Vector & Parameters, const math_Vector & V1t, const math_Vector & V2t, const Standard_Real l1, const Standard_Real l2 )

Is used after having initialized the fields. <V1t> is the tangent vector at the first point. <V2t> is the tangent vector at the last point.

 void AppDef_TheLeastSquares::Perform ( const math_Vector & Parameters, const math_Vector & V1t, const math_Vector & V2t, const math_Vector & V1c, const math_Vector & V2c, const Standard_Real l1, const Standard_Real l2 )

Is used after having initialized the fields. <V1t> is the tangent vector at the first point. <V2t> is the tangent vector at the last point. <V1c> is the tangent vector at the first point. <V2c> is the tangent vector at the last point.

 const math_Matrix& AppDef_TheLeastSquares::Points ( ) const

returns the matrix of points value.

 const math_Matrix& AppDef_TheLeastSquares::Poles ( ) const

returns the matrix of resulting control points value.

 void AppDef_TheLeastSquares::SearchIndex ( math_IntegerVector & Index )
protected
 Standard_Integer AppDef_TheLeastSquares::TheFirstPoint ( const AppParCurves_Constraint FirstCons, const Standard_Integer FirstPoint ) const
protected

returns the first point beeing fitted.

 Standard_Integer AppDef_TheLeastSquares::TheLastPoint ( const AppParCurves_Constraint LastCons, const Standard_Integer LastPoint ) const
protected

returns the last point beeing fitted.

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