*ActionOnlyForcePair()
Creates an action-only force pair.
Syntax
*ActionOnlyForcePair (force_name, "force_label", {TRANS ROT TRANS_ROT}, body, point, Optional: ref_marker)
Arguments
- force_name
- The variable name of the action-only force pair.
- force_label
- The descriptive label of the action-only force pair.
- TRANS | ROT | TRANS_ROT
- This argument indicates whether the action-only force has translational, rotational, or both translation and rotational components.
- body
- The body or body pair to which the force pair is applied.
- point
- The point or point pair at which the force pair is applied.
- ref_marker
- An optional argument for the reference marker or reference marker pair in which the components of the force pair are specified.
Example
*PointPair(p_wc, "Wheel center")
*BodyPair(b_wheel, "Wheel", p_wheel_cg)
*MarkerPair(mrk_ref, "Force reference", B_Ground, p_wc)
*ActionOnlyForcePair(frc_wc, "Applied load at wheel", TRANS_ROT, b_wheel, p_wc, mrk_ref)
Context
Properties
Property | Returns Data Type | Description |
---|---|---|
b1 | BodyPair | Body pair to which the force pair is applied. |
b2 | BodyPair | Ground body pair. |
b3 | BodyPair | Body pair to which the reference marker pair is attached. |
i | MarkerPair | Marker pair attached to b1. |
j | MarkerPair | Marker pair attached to b2. |
jfloat | MarkerPair | Floating marker pair attached to b2. |
l | ActionOnlyForce | Left force. |
label | string | The descriptive label of the action-only force pair. |
r | ActionOnlyForce | Right force. |
rm | MarkerPair | The reference marker pair in which the components of the force pair are specified. |
state | boolean | Control state (TRUE or FALSE). |
varname | string | The variable name of the action-only force pair. |
Comments
*ActionOnlyForcePair() is used to apply action-only force pairs to points or point pairs on bodies or body pairs.
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.
The individual forces of an *ActionOnlyForcePair() can be referred to as force_name.l (left force) and force_name.r (right force).