ball history command
Syntax
- ball history <name sid > keyword id id or position v
Primary keywords:
displacement displacement-x displacement-y displacement-z euler-x euler-y euler-z force-contact force-contact-x force-contact-y force-contact-z force-unbalanced force-unbalanced-x force-unbalanced-y force-unbalanced-z moment-contact moment-contact-x moment-contact-y moment-contact-z moment-unbalanced moment-unbalanced-x moment-unbalanced-y moment-unbalanced-z position-x position-y position-z rotation spin spin-x spin-y spin-z velocity velocity-x velocity-y velocity-z
Adds a history of a ball value. A history is a table of floating point values assigned by sampling a model attribute periodically during a simulation. Review the common c history commands for details regarding the manipulation of histories.
The history can be assigned a name for later reference with the optional name keyword, if not the history will be given a default name based on its internally assigned id number.
Following one of the keywords given below, either 1) an additional id keyword followed by an integer id, or 2) an additional lkwd:\(position\) keyword followed by a position vector v must be given to specify the ball whose attribute will be recorded.
- displacement
Magnitude of the accumulated ball displacement vector as a result of cycling.
- displacement-x
The x-component of accumulated displacement as a result of cycling.
- displacement-y
The y-component of accumulated displacement as a result of cycling.
- displacement-z (3D ONLY)
The z-component of accumulated displacement as a result of cycling.
- euler-x (3D ONLY)
The x-euler angle (in degrees) of the current ball orientation. The orientation is updated only when orientation tracking has been enabled (see the
model orientation-tracking
command). See the euler keyword of theball attribute
command.
- euler-y (3D ONLY)
The y-euler angle (in degrees) of the current ball orientation. The orientation is updated only when orientation tracking has been enabled (see the
model orientation-tracking
command). See the euler keyword of theball attribute
command.
- euler-z (3D ONLY)
The z-euler angle (in degrees) of the current ball orientation. The orientation is updated only when orientation tracking has been enabled (see the
model orientation-tracking
command). See the euler keyword of theball attribute
command.
- force-contact
The magnitude of the force resulting from contacts.
- force-contact-x
The x-component of the contact force.
- force-contact-y
The y-component of the contact force.
- force-contact-z (3D ONLY)
The z-component of the contact force.
- force-unbalanced
The magnitude of the unbalanced force (sum of the applied, contact and gravitational forces).
- force-unbalanced-x
The x-component of the unbalanced force.
- force-unbalanced-y
The y-component of the unbalanced force.
- force-unbalanced-z (3D ONLY)
The z-component of the unbalanced force.
- moment-contact
{Value in 2D; Magnitude in 3D} of the sum of the contact moments.
- moment-contact-x (3D ONLY)
The x-component of the contact moment.
- moment-contact-y (3D ONLY)
The y-component of the contact moment.
- moment-contact-z (3D ONLY)
The z-component of the contact moment.
- moment-unbalanced
{Value in 2D; Magnitude in 3D} of the sum of the contact and applied moments.
- moment-unbalanced-x (3D ONLY)
The x-component of the unbalanced moment.
- moment-unbalanced-y (3D ONLY)
The y-component of the unbalanced moment.
- moment-unbalanced-z (3D ONLY)
The z-component of the unbalanced moment.
- position-x
The x-component of the location of ball centroid.
- position-y
The y-component of the location of ball centroid.
- position-z (3D ONLY)
The z-component of the location of ball centroid.
- rotation (2D ONLY)
Current ball orientation. The orientation is updated only when orientation tracking has been enabled (see
model orientation-tracking
command).
- spin
{Value in 2D; Magnitude in 3D} of the ball angular velocity in radians per second.
- spin-x (3D ONLY)
The x-component of the ball angular velocity in radians per second.
- spin-y (3D ONLY)
The y-component of the ball angular velocity in radians per second.
- spin-z (3D ONLY)
The z-component of the ball angular velocity in radians per second.
- velocity
Magnitude of the ball translational velocity vector.
- velocity-x
The x-component of the ball velocity.
- velocity-y
The y-component of the ball velocity.
- velocity-z
The z-component of the ball velocity.
Was this helpful? ... | PFC 6.0 © 2019, Itasca | Updated: Nov 19, 2021 |