Dcurve/DeformableCurve

Model ElementDcurve defines a deformed curve in MotionSolve.

Class Name

Dcurve, DeformableCurve

Description

It is used in the definition of a Point-to-Deformable-Curve constraint (PTDCV)

Attribute Summary

Name Property Modifiable by command? Designable?
id Int ()    
label String ()    
end_type_left Enum ("NATURAL PARABOLIC PERIODIC CANTILEVER", default="NATURAL")    
end_type_right Enum ("NATURAL PARABOLIC PERIODIC CANTILEVER", default="NATURAL")    
markers Reference (Marker, count=0)   Yes
u_span Double (1.0) Yes  
lambda_left Double ()    
lambda_right Double ()    
tension Double () Yes  
u_closed Bool ()    

Usage

DeformableCurve (markers=list, u_span=double, optional_attributes)

Attributes

markers
List of references to existing Markers
Specifies the Marker whose origins define this deformable curve.
The markers attribute is mandatory.
u_span
Double
Specifies the parametric span of the curve. The curve parameter, u, is limited to operating in the range: -u_span/2 ≤ u ≤ u_span/2
The u_span attribute is mandatory. A good value for u_span is 1.0.
u_span > 0
id
Integer
Specifies the element identification number. This number must be unique among all the DeformableCurve objects in the model.
This attribute is optional. MotionSolve will automatically create an ID when one is not specified.
Range of values: id > 0
label
String
Specifies the name of the DeformableCurve object.
This attribute is optional. When not specified, MotionSolve will create a label for you.
end_type_left
String
Defines the end type condition for this deformed curve on the left end of the curve. end_type_left must be one of the following 4 strings:
  • "NATURAL"
  • "PARABOLIC"
  • "PERIODIC"
  • "CANTILEVER"
This attribute is optional. When not specified, it defaults to "NATURAL".
end_type_right
String
Defines the end type condition for this deformed curve on the left end of the curve. end_type_right must be one of the following 4 strings:
  • "NATURAL"
  • "PARABOLIC"
  • "PERIODIC"
  • "CANTILEVER"
This attribute is optional. When not specified, it defaults to "NATURAL".
lambda_left
Double
This parameter is only applicable for the CANTILEVER type end condition. lambda_left is a real valued parameter in the interval [0, 1] that controls the left end condition for CUBIC spline interpolation.
  • A value of 0 implies NATURAL end condition
  • A value of 1 implies PARABOLIC end condition
This attribute is optional. When not specified, it defaults to 0 ("NATURAL").
lambda_right
Double
This parameter is only applicable for the CANTILEVER type end condition. lambda_left is a real valued parameter in the interval [0, 1] that controls the left end condition for CUBIC spline interpolation.
  • A value of 0 implies NATURAL end condition
  • A value of 1 implies PARABOLIC end condition
This attribute is optional. When not specified, it defaults to 0 ("NATURAL").
u_closed
A Boolean value (True or False) that determines whether the markers that define the curves are closed or not.

Example

This example shows a simple definition of a deformed curve.
#  Define the markers whose origins will form the closed deformable curve
mvec = =[m1091, m2091, m3091, m4091, m5091, m6091, m7091, m8091, m9091, m1091]

# Define the deformable curve - with end type = NATURAL
dc1 = DeformableCurve (markers=mvec, u_span=1.0)

Comments

  1. See Properties for an explanation about what properties are, why they are used, and how you can extend these.
  2. For a more detailed explanation about Dcurve, see Reference: Deform Curve.