*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.
Data type: varname
force_label
The descriptive label of the action-only force pair.
Data type: label
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.
Data type: Body or BodyPair
point
The point or point pair at which the force pair is applied.
Data type: Point or PointPair
ref_marker
An optional argument for the reference marker or reference marker pair in which the components of the force pair are specified.
Data type: Marker or MarkerPair

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

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

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).