Fmag_AvgForce Status

Application
Force Monitor Object FM#

Description
Returns average resultant force.

Usage
FGet Object.Fmag_AvgForce, rVar

  • Object
    Object name
    The object is specified as either of FM (numerical value) or FM (label).

  • rVar
    A real number variable defining the value of the property

Detailed Explanation
Fmag_AvgForce returns the average resultant force.
Execute AvgForceClear before executing Fmag_AvgForce. Without executing AvgForceClear, “0” is returned.
If the time between executing AvgForceClear and executing Fmag_AvgForce is short, an error in the force and torque averages will occur. Establish a low-pass filter with a time constant of about 5 times between the AvgForceClear and the Fmag_AvgForce execution.
There is a time limit on Fmag_AvgForce. Execute Fmag_AvgForce within 600 seconds of executing AvgForceClear. When Fmag_AvgForce is executed after 600 seconds has passed, an error is generated.

Usage Example
This is an example of acquiring the average resultant force.

Function CheckAverageForce
  Double AF
  FSet FC1.Enabled, True, False, False, False, False, False
  FSet FC1.TargetForces, 10, 0, 0, 0, 0, 0
  FSet FS1.Reset
  FSet FM1.CoordinateSystem, FCS0
  FSet FM1.AvgForceClear, False, False, False, False, False, False, True, False
  FCKeep FC1, 10
  FGet FM1.Fmag_AvgForce, AF
  Print AF
Fend

See Also
Force Monitor Object FM#