AvgForces Result

Description
Returns average values of force and torque during execution of a force guide object.

Usage
FGGet Sequence.Object.AvgForces, rArray()

  • Sequence
    Force guide sequence name
  • Object
    Force guide object name
  • rArray
    Real array variable with six or more elements showing returned values

Values
rArray()

Element number Element number constant Description
0 FG_FX Acquires average value of force in Fx direction during execution of a force guide object.
1 FG_FY Acquires average value of force in Fy direction during execution of a force guide object.
2 FG_FZ Acquires average value of force in Fz direction during execution of a force guide object.
3 FG_TX Acquires average value of torque in Tx direction during execution of a force guide object.
4 FG_TY Acquires average value of torque in Ty direction during execution of a force guide object.
5 FG_TZ Acquires average value of torque in Tz direction during execution of a force guide object.

Detailed Explanation
Returns average values of force and torque during execution of a force guide object.
If the number of elements in a specified array variable is less than six, returns force and torque in each direction for the defined element numbers.
Also, if the number of elements in the array variable exceeds six, returns force and torque in each direction from element number 0 to 5, while making no change to element number 6 and above.

Usage Example
The following is an example of a simple program that acquires a result with FGGet.

Function AvgForceTest
  Double dArray(6)
  Motor On
  FGRun Sequence1
  FGGet Sequence1.Contact01.AvgForces, dArray()  ' Acquisition of AvgForces
  Print dArray(FG_FX)
Fend

See Also
FGGet, Contact object, Relax object, FollowMove object, SurfaceAlign object, PressProbe object, ContactProbe object, Press object, PressMove object, Paste object, ScrewTighten object, ScrewRetighten object, HeightInspect object, Insert object, TensileTest object