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