Dsurface/DeformableSurface

Model Element

Class Name

Dsurface or DeformableSurface

Description

Dsurface defines a deformable surface in MotionSolve. It is referred to by PTDSF and PTDSFF.

Attribute Summary

Name	Property	Modifiable by command?
id	Int ()
label	String ()	✓
end_type	Enum ("NATURAL PARABOLIC PERIODIC", default="NATURAL")
markers	Reference (Marker, count=0)
u_span	Double (1.0)	✓
v_span	Double (1.0)	✓
u_tension	Double ()	✓
v_tension	Double ()	✓
u_closed	Bool ()
v_closed	Bool ()
active	Bool ()	✓

Usage

Dsurface (markers=objMatrix, optional_attributes)

Attributes

markers

Matrix of Marker objects

Specifies a matrix of Markers. The origins of these Markers define the deformable surface. The Markers in the matrix are to be organized as shown in the image below.

dsurface_api_fig1

The markers attribute is mandatory.

Integer

Specifies the element identification number. This number must be unique among all the Dsurface 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 Dsurface object.

This attribute is optional. When not specified, MotionSolve will create a label for you.

end_type

String

Defines the end type of this deformed surface. Select one from NATURAL, PARABOLIC, PERIODIC or CANTILEVER. See Comment 8 for more details.

This attribute is optional.

Default = NATURAL

u_span

Double

Specifies the range of the u parameter for the deformable surface. During simulation, MotionSolve will ensure that u_span/2 ≤ u ≤ + u_span/2

This attribute is optional.

u_span > 0.0

Default = 1.0

v_span

Double

Specifies the range of the v parameter for the deformable surface. During simulation, MotionSolve will ensure that v_span/2 ≤ v ≤ + v_span/2

This attribute is optional.

v_span > 0.0

Default = 1.0

u_closed

A Boolean value (True or False) that determines whether the markers that define the curves are closed in u or not.

v_closed

A Boolean value (True or False) that determines whether the markers that define the curves are closed in v or not.

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 Dsurface, see the Comments in the XML syntax section

Examples

1.	Create a deformed surface with a minimum number of attributes.

mkrMatrix = [ [m11, m12, m13, m14, m15, m16, m17, m11],

[m21, m22, m23, m24, m25, m26, m27, m21],

[m31, m32, m33, m34, m35, m36, m37, m31],

[m41, m42, m43, m44, m45, m46, m47, m41],

[m51, m52, m53, m54, m55, m56, m57, m51],

[m61, m62, m63, m64, m65, m66, m67, m61],

[m71, m72, m73, m74, m75, m76, m77, m71],

[m11, m12, m13, m14, m15, m16, m17, m11] ]

Dsurface (markers=mkrmatrix))

The following default properties are automatically provided:

•	end_type = NATURAL

•	u_span = 1.0

•	v_span = 1.0

•	uclosed = True (first and last columns are the same)

•	vclosed = True (first and last rows are the same)