Adams Basic Package > Adams View > View Function Builder > Run-Time Functions > Functions: N - Z > Three-component Force (VFORCE)

Three-component Force (VFORCE)

Returns a force or torque applied by a specified three-component force on one or two bodies directly affected by the three-component force.

Format

VFORCE (Three-component Force, On This Body, Force Component, Along Axes)

Arguments

 
Three-component Force
(Required) Three-component force for which the force is measured.
On This Body
(Required) Body on which the force is measured.
The legal values are:
■0 = forces and torques on the first body, at the I marker
■1 = forces and torques on the second body, at the J marker
Force Component
(Required) Force or torque component you want to measure.
The legal values are:
■Fm = 1 = force magnitude
■Fx = 2 = x component of the force
■Fy = 3 = y component of the force
■Fz = 4 = z component of the force
■Tm = 5 = torque magnitude
■Tx = 6 = x component of the torque
■Ty = 7 = y component of the torque
■Tz = 8 = z component of the torque
Along/About Axes
(Optional) Coordinate system marker in which the results are measured.
To have your results measured in the global coordinate system, do one of the following:
■If you're entering your function through the Assist dialog box, leave the Along/About Axes text box empty.
■If you're entering your function directly in the function text box, enter a 0.

Examples

The following function returns the x component of the force vector acting on the second body (at the J marker) due to the three-component force named .model_1.vforce_31, measured along the x-axis of the global coordinate system:
VFORCE(.model_1.vforce_31, 1, 2, 0)
The following function returns the z component of the force vector acting on the first body (at the I marker) due to the three-component force named .contact_force, measured along the z-axis of marker_6:
VFORCE(contact_force, 0, 4, marker_6)
Learn more about force in object functions.