ball list
command
Syntax
 ball list <keyword> <range>

List ball information. By default, the ball ID, radius, active/total contact count, fixity, and position are listed. Use the attribute keyword to list all ball attributes that can be listed.
Note
Use the
model precision
command to change the precision of listed floating point values. attribute keyword
List ball attributes. If no keyword is given, then the available attributes are listed.
Attributes are characteristics of balls such as mass and velocity. These are distinct from properties that represent surface conditions and are used in contact models to delineate interactions.
 damp
Ball local damping coefficient.
 density
Ball density.
 displacement
Accumulated ball displacement vector as a result of cycling.
 displacementx
The \(x\)component of the accumulated ball displacement as a result of cycling.
 displacementy
The \(y\)component of the accumulated ball displacement as a result of cycling.
 displacementz (3D ONLY)
The \(z\)component of the accumulated ball displacement as a result of cycling.
 euler (3D ONLY)
Current orientation of Euler angles following the X,Y,Z convention (e.g., rotation about the \(x\)axis followed by rotation about the y’axis followed by rotation about the z’‘axis) in degrees. The orientation is updated only when orientation tracking has been enabled (see
model orientationtracking
command). When active, the current ball orientation can be visualized.
 eulerx (3D ONLY)
The \(x\)euler angle (in degrees) of the current ball orientation. See the euler keyword for further details.
 eulery (3D ONLY)
The \(y\)euler angle (in degrees) of the current ball orientation. See the euler keyword for further details.
 eulerz (3D ONLY)
The \(z\)euler angle (in degrees) of the current ball orientation. See the euler keyword for further details.
 forceapplied
Force applied to balls.
 forceappliedx
The \(x\)component of the force applied to balls.
 forceappliedy
The \(y\)component of the force applied to balls.
 forceappliedz (3D ONLY)
The \(z\)component of the force applied to balls.
 forcecontact
Sum of the contact force accumulated to the balls during the previous forcedisplacement update. This value will be modified during the next forcedisplacement update.
 forcecontactx
The \(x\)component of the contact force.
 forcecontacty
The \(y\)component of the contact force.
 forcecontactz (3D ONLY)
The \(z\)component of the contact force.
 fragment
Fragment ID (see “Fragment”).
 momentapplied
Moment applied to balls.
 momentappliedx (3D ONLY)
The \(x\)component of the moment applied to balls.
 momentappliedy (3D ONLY)
The \(y\)component of the moment applied to balls.
 momentappliedz (3D ONLY)
The \(z\)component of the moment applied to balls.
 momentcontact
Sum of the contact moments accumulated to the balls during the previous forcedisplacement update. This value will be modified during the next forcedisplacement update.
 momentcontactx (3D ONLY)
The \(x\)component of the contact moment.
 momentcontacty (3D ONLY)
The \(y\)component of the contact moment.
 momentcontactz (3D ONLY)
The \(z\)component of the contact moment.
 position
Location of ball centroid. Note that the model should be cleaned (see the
model clean
command) after this command is issued to ensure that potential contacts with neighboring pieces are updated.
 positionx
The \(x\)component of the location of ball centroids.
 positiony
The \(y\)component of the location of ball centroids.
 positionz (3D ONLY)
The \(z\)component of the location of ball centroids.
 radius
Ball radius.
 rotation (2D ONLY)
Current ball orientation. The orientation is updated only when orientation tracking has been enabled (see
model orientationtracking
command).
 spin
Ball angular velocity.
 spinx (3D ONLY)
The \(x\)component of the ball angular velocity in radians.
 spiny (3D ONLY)
The \(y\)component of the ball angular velocity in radians.
 spinz (3D ONLY)
The \(z\)component of the ball angular velocity in radians.
 velocity
Ball translational velocity vector.
 velocityx
The \(x\)component of the ball velocity.
 velocityy
The \(y\)component of the ball velocity.
 velocityz (3D ONLY)
The \(z\)component of the ball velocity.
 contact <all>
List the contacts with a ball. The contact ID, ID of the other contacting piece, contact type, activity state, inhibited state, and contact model are listed. By default, only active contacts are listed. Use the all keyword to list active and inactive contacts.
 property <s >
List ball properties. If no s is given, then the available properties are listed for each ball. If s is specified, then the value of that property is listed for each ball.
Properties represent surface conditions and are used in contact models to delineate interactions. These are distinct from attributes that are characteristics of balls such as mass and velocity.
 result
List the ball model results that have been tabulated. See the
ball results
command for further details.
Usage Examples
List the value stored in the extra variable at index 2 for all balls.
ball list extra 2
List the applied force for all balls.
ball list attribute forceapplied
List the value of the property kn
(normal stiffness) for all balls.
ball list prop 'kn'
Was this helpful? ...  PFC © 2021, Itasca  Updated: Feb 25, 2024 