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

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

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

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.