FairCurve

Constructor with the two points and the geometrical characteristics of the batten (elastic beam) 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 :

• FreeSliding = False
• ConstraintOrder1 = 1
• ConstraintOrder2 = 1
• Angle1 = 0
• Angle2 = 0
• SlidingFactor = 1 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.

Freesliding is initialized with the default setting false. 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.

Allows you to change the order of the constraint on the first point. ConstraintOrder has the default setting of 1. The following settings are available:

• 0-the curve must pass through a point
• 1-the curve must pass through a point and have a given tangent
• 2-the curve must pass through a point, have a given tangent and a given curvature. The third setting is only valid for FairCurve_MinimalVariation curves. These constraints, though geometric, represent the mechanical constraints due, for example, to the resistance of the material the actual physical batten is made of.

Allows you to change the order of the constraint on the second point. ConstraintOrder is initialized with the default setting of 1. The following settings are available:

• 0-the curve must pass through a point
• 1-the curve must pass through a point and have a given tangent
• 2-the curve must pass through a point, have a given tangent and a given curvature. The third setting is only valid for FairCurve_MinimalVariation curves. These constraints, though geometric, represent the mechanical constraints due, for example, to the resistance of the material the actual physical batten is made of.

Allows you to change the location of the point, P1, and in 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.

Allows you to change the location of the point, P1, and in 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.

Allows you to change the angle Angle1 at the first point, P1. The default setting is 0.

Allows you to change the angle Angle2 at the second point, P2. The default setting is 0.

Allows you to change the height of the deformation. Raises NegativeValue; - if Height <= 0 if Height <= 0.

Allows you to set the slope value, Slope.

Allows you to change the ratio SlidingFactor. This 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:

• if you increase the value, it inflates the batten
• if you decrease the value, it flattens the batten. When sliding is free, the sliding factor is automatically computed to satisfy the equilibrium of the batten. When sliding is imposed, a value is required for the sliding factor. SlidingFactor is initialized with the default setting of 1.

Performs the algorithm, using the arguments Code, NbIterations and Tolerance and computes the curve with respect to the constraints. Code will have one of the following values:

• OK
• NotConverged
• InfiniteSliding
• NullHeight The parameters Tolerance and NbIterations control how precise the computation is, and how long it will take.

Computes the real number value for length Sliding of 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.

Returns the initial free sliding value, false by default. 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.

Returns the established first constraint order.

Returns the established second constraint order.

Returns the established location of the point P1.

Returns the established location of the point P2.

Returns the established first angle.

Returns the established second angle.

Returns the thickness of the lathe.

Returns the established slope value.

Returns the initial sliding factor.

Returns the computed curve a 2d BSpline.

Constructor of linear batten with Heigth : the Heigth at the middle point Slope : the geometric slope of the batten Sliding : Active Length of the batten without extension.

Change the value of sliding.

Change the value of Heigth at the middle point.

Change the value of the geometric slope.

computes the value of the heigth for the parameter T on the neutral fibber

returns the number of variables of the function.

returns the number of equations of the function.

computes the values <F> of the functions for the variable <X>. returns True if the computation was done successfully, False otherwise.

computes the values <F> of the functions for the variable <X>. returns True if the computation was done successfully, False otherwise.

change the length sliding

computes the values <F> of the functions for the variable <X>. returns True if the computation was done successfully, False otherwise.

returns the number of variables of the energy.

computes the values of the Energys E for the variable <X>. Returns True if the computation was done successfully, False otherwise.

computes the gradient <G> of the energys for the variable <X>. Returns True if the computation was done successfully, False otherwise.

compute the variables <X> which correspond with the field <MyPoles>

return the poles

Angles correspond to the Ox axis.

return the lengthSliding = P1P2 + Sliding

return the status

compute the variables <X> which correspond with the field <MyPoles>

Angles correspond to the Ox axis.

return the lengthSliding = P1P2 + Sliding

return the status

compute the variables <X> which correspond with the field <MyPoles>

Constructs the two contact points P1 and P2 and the geometrical characteristics of the batten (elastic beam) 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

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

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

Allows you to set the physical ratio Ratio. 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.

Computes the curve with respect to the constraints, 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.

Returns the first established curvature.

Returns the second established curvature.

Returns the physical ratio, or kind of energy.

The tolerance required on the solution is given by Tolerance. Iteration are stopped if (!WithSingularity) and H(F(Xi)) is not definite positive (if the smaller eigenvalue of H < Convexity) or IsConverged() returns True for 2 successives Iterations. Warning: This constructor do not computation.

This method is called at the end of each iteration to check the convergence: || Xi+1 - Xi || < SpatialTolerance/100 Or || Xi+1 - Xi || < SpatialTolerance and |F(Xi+1) - F(Xi)| < CriteriumTolerance * |F(xi)| It can be redefined in a sub-class to implement a specific test.