Open CASCADE Technology  6.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Public Member Functions
FairCurve_MinimalVariation Class Reference

Computes a 2D curve using an algorithm which
minimizes tension, sagging, and jerk energy. As in
FairCurve_Batten, two reference points are used.
Unlike that class, FairCurve_MinimalVariation
requires curvature settings at the first and second
reference points. These are defined by the rays of
curvature desired at each point.
More...

#include <FairCurve_MinimalVariation.hxx>

Inheritance diagram for FairCurve_MinimalVariation:
Inheritance graph
[legend]

Public Member Functions

 FairCurve_MinimalVariation (const gp_Pnt2d &P1, const gp_Pnt2d &P2, const Standard_Real Heigth, const Standard_Real Slope=0, const Standard_Real PhysicalRatio=0)
 
 Constructs the two contact points P1 and P2  and the geometrical <br>
     characteristics of the batten (elastic beam) <br>

These include the real number values for height of
deformation Height, slope value Slope, and kind of
energy PhysicalRatio. The kinds of energy include:
More...

 
void SetCurvature1 (const Standard_Real Curvature)
 Allows you to set a new constraint on curvature at the first point.
More...
 
void SetCurvature2 (const Standard_Real Curvature)
 
 Allows you to set a new constraint on curvature at the second point. <br>


More...

 
void SetPhysicalRatio (const Standard_Real Ratio)
 
  Allows you to set the physical ratio Ratio. <br>

The kinds of energy which you can specify include:
0 is only "Jerk" Energy
1 is only "Sagging" Energy like batten
Warning: if Ratio is 1 it is impossible to impose curvature constraints.
Raises DomainError if Ratio < 0 or Ratio > 1
More...

 
virtual Standard_Boolean Compute (FairCurve_AnalysisCode &ACode, const Standard_Integer NbIterations=50, const Standard_Real Tolerance=1.0e-3)
 
 Computes the curve with respect to the constraints, <br>

NbIterations and Tolerance. The tolerance setting
allows you to control the precision of computation, and
the maximum number of iterations allows you to set a limit on computation time.
More...

 
Standard_Real GetCurvature1 () const
 Returns the first established curvature.
More...
 
Standard_Real GetCurvature2 () const
 Returns the second established curvature.
More...
 
Standard_Real GetPhysicalRatio () const
 Returns the physical ratio, or kind of energy.
More...
 
virtual void Dump (Standard_OStream &o) const
 Prints on the stream o information on the current state
of the object.
Is used to redefine the operator <<.
More...
 
- Public Member Functions inherited from FairCurve_Batten
 FairCurve_Batten (const gp_Pnt2d &P1, const gp_Pnt2d &P2, const Standard_Real Height, const Standard_Real Slope=0)
 
 Constructor  with the two points and the geometrical <br>
     characteristics of the batten (elastic beam) <br>

Height is the height of the deformation, and Slope is the
slope value, initialized at 0. The user can then supply the
desired slope value by the method, SetSlope.
Other parameters are initialized as follow :
More...

 
virtual void Delete ()
 
virtual ~FairCurve_Batten ()
 
void SetFreeSliding (const Standard_Boolean FreeSliding)
 
 Freesliding is initialized with the default setting false. <br>

When Freesliding is set to true and, as a result, sliding
is free, the sliding factor is automatically computed to
satisfy the equilibrium of the batten.

More...

 
void SetConstraintOrder1 (const Standard_Integer ConstraintOrder)
 
 Allows you to change the order of the constraint on the <br>

first point. ConstraintOrder has the default setting of 1.
The following settings are available:
More...

 
void SetConstraintOrder2 (const Standard_Integer ConstraintOrder)
 
 Allows you to change the order of the constraint on the <br>

second point. ConstraintOrder is initialized with the default setting of 1.
The following settings are available:
More...

 
void SetP1 (const gp_Pnt2d &P1)
 
 Allows you to change the location of the point, P1, and in <br>

doing so, modify the curve.
Warning
This method changes the angle as well as the point.
Exceptions
NullValue if the distance between P1 and P2 is less
than or equal to the tolerance value for distance in
Precision::Confusion: P1.IsEqual(P2,
Precision::Confusion()). The function
gp_Pnt2d::IsEqual tests to see if this is the case.
More...

 
void SetP2 (const gp_Pnt2d &P2)
 
 Allows you to change the location of the point, P1, and in <br>

doing so, modify the curve.
Warning
This method changes the angle as well as the point.
Exceptions
NullValue if the distance between P1 and P2 is less
than or equal to the tolerance value for distance in
Precision::Confusion: P1.IsEqual(P2,
Precision::Confusion()). The function
gp_Pnt2d::IsEqual tests to see if this is the case.
More...

 
void SetAngle1 (const Standard_Real Angle1)
 
 Allows you to change the angle Angle1 at the first point, <br>

P1. The default setting is 0.

More...

 
void SetAngle2 (const Standard_Real Angle2)
 
 Allows you to change the angle Angle2 at the second <br>

point, P2. The default setting is 0.

More...

 
void SetHeight (const Standard_Real Height)
 
 Allows you to change the height of the deformation. <br>

Raises NegativeValue; – if Height <= 0
if Height <= 0
More...

 
void SetSlope (const Standard_Real Slope)
 Allows you to set the slope value, Slope.
More...
 
void SetSlidingFactor (const Standard_Real SlidingFactor)
 
 Allows you to change the ratio SlidingFactor. This <br>

compares the length of the batten and the reference
length, which is, in turn, a function of the constraints.
This modification has one of the following two effects:
More...

 
Standard_Real SlidingOfReference () const
 
  Computes the real number value for length Sliding of <br>

Reference for new constraints. If you want to give a
specific length to a batten curve, use the following
syntax: b.SetSlidingFactor(L /
b.SlidingOfReference()) where b is the
name of the batten curve object.
More...

 
Standard_Boolean GetFreeSliding () const
 
 Returns the initial free sliding value, false by default. <br>

Free sliding is generally more aesthetically pleasing
than constrained sliding. However, the computation can
fail with values such as angles greater than PI/2. This is
because the resulting batten length is theoretically infinite.
More...

 
Standard_Integer GetConstraintOrder1 () const
 Returns the established first constraint order.
More...
 
Standard_Integer GetConstraintOrder2 () const
 Returns the established second constraint order.
More...
 
const gp_Pnt2d & GetP1 () const
 Returns the established location of the point P1.
More...
 
const gp_Pnt2d & GetP2 () const
 Returns the established location of the point P2.
More...
 
Standard_Real GetAngle1 () const
 Returns the established first angle.
More...
 
Standard_Real GetAngle2 () const
 Returns the established second angle.
More...
 
Standard_Real GetHeight () const
 Returns the thickness of the lathe.
More...
 
Standard_Real GetSlope () const
 Returns the established slope value.
More...
 
Standard_Real GetSlidingFactor () const
 Returns the initial sliding factor.
More...
 
Handle_Geom2d_BSplineCurve Curve () const
 Returns the computed curve a 2d BSpline.
More...
 

Additional Inherited Members

- Protected Member Functions inherited from FairCurve_Batten
Standard_Real SlidingOfReference (const Standard_Real D, const Standard_Real A1, const Standard_Real A2) const
 
Standard_Real Compute (const Standard_Real D, const Standard_Real A1, const Standard_Real A2) const
 
Standard_Real Compute (const Standard_Real D, const Standard_Real A) const
 Returns the effective geometrical constraints at the
last batten computation. This effectives values may
be not equal with the wanted values if
More...
 
- Protected Attributes inherited from FairCurve_Batten
FairCurve_AnalysisCode myCode
 
gp_Pnt2d OldP1
 
gp_Pnt2d OldP2
 
Standard_Real OldAngle1
 
Standard_Real OldAngle2
 
Standard_Real OldHeight
 
Standard_Real OldSlope
 
Standard_Real OldSlidingFactor
 
Standard_Boolean OldFreeSliding
 
Standard_Integer OldConstraintOrder1
 
Standard_Integer OldConstraintOrder2
 
gp_Pnt2d NewP1
 
gp_Pnt2d NewP2
 
Standard_Real NewAngle1
 
Standard_Real NewAngle2
 
Standard_Real NewHeight
 
Standard_Real NewSlope
 
Standard_Real NewSlidingFactor
 
Standard_Boolean NewFreeSliding
 
Standard_Integer NewConstraintOrder1
 
Standard_Integer NewConstraintOrder2
 
Standard_Integer Degree
 
Handle_TColgp_HArray1OfPnt2d Poles
 
Handle_TColStd_HArray1OfReal Flatknots
 
Handle_TColStd_HArray1OfReal Knots
 
Handle_TColStd_HArray1OfInteger Mults
 

Detailed Description

Computes a 2D curve using an algorithm which
minimizes tension, sagging, and jerk energy. As in
FairCurve_Batten, two reference points are used.
Unlike that class, FairCurve_MinimalVariation
requires curvature settings at the first and second
reference points. These are defined by the rays of
curvature desired at each point.

Constructor & Destructor Documentation

FairCurve_MinimalVariation::FairCurve_MinimalVariation ( const gp_Pnt2d &  P1,
const gp_Pnt2d &  P2,
const Standard_Real  Heigth,
const Standard_Real  Slope = 0,
const Standard_Real  PhysicalRatio = 0 
) 

 Constructs the two contact points P1 and P2  and the geometrical <br>
     characteristics of the batten (elastic beam) <br>

These include the real number values for height of
deformation Height, slope value Slope, and kind of
energy PhysicalRatio. The kinds of energy include:

  • Jerk (0)
  • Sagging (1).
    Note that the default setting for Physical Ration is in FairCurve_Batten
    Other parameters are initialized as follow :
    • FreeSliding = False
    • ConstraintOrder1 = 1
    • ConstraintOrder2 = 1
    • Angle1 = 0
    • Angle2 = 0
    • Curvature1 = 0
    • Curvature2 = 0
    • SlidingFactor = 1
      Warning
      If PhysicalRatio equals 1, you cannot impose constraints on curvature.
      Exceptions
      NegativeValue if Height is less than or equal to 0.
      NullValue if the distance between P1 and P2 is less
      than or equal to the tolerance value for distance in
      Precision::Confusion: P1.IsEqual(P2,
      Precision::Confusion()). The function
      gp_Pnt2d::IsEqual tests to see if this is the case.
      //! Definition of the geometricals constraints

Member Function Documentation

virtual Standard_Boolean FairCurve_MinimalVariation::Compute ( FairCurve_AnalysisCode &  ACode,
const Standard_Integer  NbIterations = 50,
const Standard_Real  Tolerance = 1.0e-3 
)
virtual 

 Computes the curve with respect to the constraints, <br>

NbIterations and Tolerance. The tolerance setting
allows you to control the precision of computation, and
the maximum number of iterations allows you to set a limit on computation time.

Reimplemented from FairCurve_Batten.

virtual void FairCurve_MinimalVariation::Dump ( Standard_OStream &  o) const
virtual

Prints on the stream o information on the current state
of the object.
Is used to redefine the operator <<.

Reimplemented from FairCurve_Batten.

Standard_Real FairCurve_MinimalVariation::GetCurvature1 ( ) const

Returns the first established curvature.

Standard_Real FairCurve_MinimalVariation::GetCurvature2 ( ) const

Returns the second established curvature.

Standard_Real FairCurve_MinimalVariation::GetPhysicalRatio ( ) const

Returns the physical ratio, or kind of energy.

void FairCurve_MinimalVariation::SetCurvature1 ( const Standard_Real  Curvature)

Allows you to set a new constraint on curvature at the first point.

void FairCurve_MinimalVariation::SetCurvature2 ( const Standard_Real  Curvature) 

 Allows you to set a new constraint on curvature at the second point. <br>


void FairCurve_MinimalVariation::SetPhysicalRatio ( const Standard_Real  Ratio) 

  Allows you to set the physical ratio Ratio. <br>

The kinds of energy which you can specify include:
0 is only "Jerk" Energy
1 is only "Sagging" Energy like batten
Warning: if Ratio is 1 it is impossible to impose curvature constraints.
Raises DomainError if Ratio < 0 or Ratio > 1

The documentation for this class was generated from the following file:
Generated on Tue Apr 29 2014 15:37:23 for Open CASCADE Technology by   doxygen 1.8.5