Adams Basic Package > Adams View > View Function Builder > Run-Time Functions > Functions: N - Z > Six-component Force/Torque (GFORCE)

Six-component Force/Torque (GFORCE)

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

Format

GFORCE (Six-component Force/Torque, On This Body, Force Component, Along/About Axes)

Arguments

 
Six-component Force/Torque
(Required) Six-component force/torque 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.
The magnitude and units calculated for the six force (Fx, Fy, Fz) and torque (Tx, Ty, Tz) components will depend upon the expressions or subroutines you supply. These expressions are generally written in terms of runtime functions displacements, velocities and rotation (velocity) angles by the use of functions like Distance Along X (DX), Angle About X (AX), Velocity Along X (VX), Angular Velocity About X (WX), and so on.

Example

The following function returns the z component of the force vector acting on the first body (at the I marker) of .model_3.gforce_31, measured along the z-axis of marker_23:
GFORCE(.model_3.gforce_31, 0, 4, marker_23)
Learn more about force in object functions.