*Field()
Creates a field.
Syntax
*Field(field_name,"field_label",body_1, body_2, origin)
Arguments
- field_name
- The variable name of the field.
- field_label
- The descriptive label of the field.
- body_1
- The first body constrained by the field.
- body_2
- The second body constrained by the field.
- origin
- The location of the field.
Example
*BeginMDL(model, "Field Model")
*Body(b_0, "Body 0")
*Body(b_1, "Body 1")
*Point(p_0, "Point 0")
*Point(p_1, "Point 1")
*Point(p_2, "Point 2")
*Vector(v_1, "Vector 1")
*Vector(v_2, "Vector 2")
*Field(fi_0, "Field 0 - Single", b_0, b_1, p_0)
*SetOrientation(fi_0, TWOAXES, XY, v_1, v_2)
*SetOrientation(fi_0, TWOAXES, XY, p_1, p_2)
*SetOrientation(fi_0, ONEAXIS, X, p_1)
*SetOrientation(fi_0, ONEAXIS, X, v_1)
*SetFieldStiffness(fi_0, 1, 2, 3...36)
*SetFieldDamping(fi_0, CRATIO, .05)
*SetFieldLength(fi_0, 5, 6, 7, 8, 9, 10)
*SetFieldForce(fi_0, 21, 22, 23, 24, 25, 26)
*EndMDL()
Context
Properties
Property | Returns Data Type | Description |
---|---|---|
align_meth1 | The alignment method used to orient the first axis of the field. | |
align_meth2 | The alignment method used to define the plane created by the first two axes of the field. Used only when the orientation method is Two Axes. | |
align_pt1 | Point | The point used to define the first axis of the field. Used when align_meth1 is of type Point. |
align_pt2 | Point | The point used to define the plane for align_meth2. Used when the orientation method is Two Axes. |
align_vec1 | Vector | The vector used to define the first axis of the field. Used when align_meth2 is of type Vector. |
align_vec2 | Vector | The vector used to define the plane for align_meth2. Used when the orientation method is Two Axes |
AX, AY, AZ | real | Shortcut notation for a curve independent variable when the independent variable is translational acceleration. |
b1 | Body | The first body constrained by the field. |
b2 | Body | The second body constrained by the field. |
c1 - c36 | real | The damping coefficients of the 6x6 damping matrix. |
DX, DY, DZ | real | Shortcut notation for a curve independent variable when the indepenent variable is translational displacement. |
e1, e2, e3 | real | The Euler angles used if ornt_meth is Angles. |
f1 - f6 | real | The force values for the six components (3 forces, 3 torques) at the corresponding lengths (length1 - length6). Zero force would mean a free length at the given lengths. |
FM, FX, FY, FZ | real | Shortcut notation for a curve independent variable when the indepenent variable is translational force. |
full_label | string | The descriptive label of the field, starting at "MODEL". |
full_local_label | string | The label of the field that does not include "MODEL" and parent systems. |
full_local_vaname | string | The variable name of the field that does not include "MODEL" and parent systems. |
full_varname | string | The variable name of the field, starting at "MODEL". |
i | Marker | The implicit marker on b1. |
id | long integer | The solver ID of the field. |
idstring | string | The solver ID represented as a string. |
j | Marker | The implicit marker on b2. |
jfloat | Marker | The implicit floating marker on b2. |
k1 - k36 | real | Stiffness values of the 6x6 stiffness matrix. |
label | string | The descriptive label of the field. |
length 1 - length 6 | real | The reference lengths between the i marker and the j marker. |
local_dll | string | The path and filename of the local DLL to be used. Applicable only if use_local_dll is set to TRUE. |
note | string | The note on the field. |
num | integer | The unique identification number within MDL. |
origin | Point | The origin of the field entity. |
ornt_dir1 | The axis type that is being oriented for the first axis of the field. | |
ornt_dir2 | The axis type that is being oriented to define the plane. | |
ornt_meth | The type of orientation used for the field. | |
rm | Marker | The reference marker used when the orientation method is Angles. |
state | boolean | Control state (TRUE or FALSE). |
TM, TX, TY, TZ | real | Shortcut notation for a curve independent variable when the indepenent variable is torque. |
_user_state | boolean | The state that can be set by the user (TRUE or FALSE). |
use_local_dll | boolean | The flag for whether a DLL specific to an instance of the field entity will be used. |
user | boolean | Set to TRUE if the field properties will be described by a user subroutine. |
usr_sub | string | The solver expression that sets the arguments for the user-defined field. |
usr_type | string | Indicates that the field will be described by a user subroutine. Valid settings include USER. |
varname | string | The variable name of the field. |
VX, VY, VZ | real | Shortcut notation for a curve independent variable when the indepenent variable is translational velocity. |
WX, WY, WZ | real | Shortcut notation for a curve independent variable when the indepenent variable is rotational velocity. |
x1, y1, z1 | real | The values for the components of a vector when align_meth1 is DxDyDz (not related to the DXDYDZ curve shortcut notation). |
x2, y2, z2 | real | The values for the components of a vector when align_meth2 is DxDyDz (not related to the DXDYDZ curve shortcut notation). |