*ActionOnlyForce()
Creates an action-only force.
Syntax
*ActionOnlyForce (force_name, "force_label", { TRANS ROT TRANS_ROT }, body, point, Optional: ref_marker)
Arguments
- force_name
- The variable name of the action-only force.
- force_label
- The descriptive label of the action-only force.
- TRANS | ROT | TRANS_ROT
- This argument indicates whether the action-only force has translational, rotational, or both translation and rotational components.
- body
- The body to which the force is applied.
- point
- The point at which the force is applied.
- ref_marker
- An optional argument for the reference marker in which the components of the force are specified.
Example
*Point(p_wc, "Wheel center")
*Body(b_wheel, "Wheel", p_wheel_cg)
*Marker(mrk_ref, "Force reference", B_Ground, p_wc)
*ActionOnlyForce(frc_wc, "Applied load at wheel", TRANS, b_wheel, p_wc, mrk_ref)
Context
Properties
Property | Returns Data Type | Description |
---|---|---|
b1 | Body | Body to which the force is applied. |
b2 | Body | Ground body. |
b3 | Body | Body to which the reference marker is attached. |
fx, fy, fz | real or string | A number, MDL expression, or solver expression that determines the value of the translational X, Y, and Z components of the force. |
i | Marker | Marker attached to b1. |
j | Marker | Marker attached to b2. |
jfloat | Marker | Floating marker attached to b2. |
label | string | The descriptive label of the action-only force. |
rm | Marker | The reference marker in which the components of the force are specified. |
state | boolean | Control state (TRUE or FALSE). |
id | long integer | The solver ID of the action-only force. |
tx, ty, tz | real or string | A number, MDL expression, or solver expression that determines the value of the rotational force about the X, Y, and Z axis. |
varname | string | The variable name of the action-only force. |
Comments
*ActionOnlyForce() is used to apply action-only forces to points on bodies.
Action-only forces do not have a reaction-force component.
If the optional argument for ref_marker is not specified, a global inertial frame is used as the reference marker for specifying force components.