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