rblock list
command
Syntax
 rblock list <keyword> <range>

List rigid block information. By default, the rigid block ID, active/total contact count, fixity, and position are listed. Use the attribute keyword to list all rigid block attributes that can be listed.
Note
 Use the
model precision
command to change the precision of listed floating point values.
 attribute <keyword>
List rigid block attributes. If no keyword is given, then the available attributes are listed. If a keyword is specified, then the value of that attribute is listed for each rigid block.
Attributes are characteristics of rigid blocks such as mass and velocity. These are distinct from properties that represent surface conditions and are used in contact models to delineate interactions.
 damp
Rigid block local damping coefficient.
 density
Rigid block density.
 displacement
Accumulated rigid block displacement vector as a result of cycling.
 displacementx
The \(x\)component of the accumulated rigid block displacement as a result of cycling.
 displacementy
The \(y\)component of accumulated displacement as a result of cycling.
 displacementz (3D ONLY)
The \(z\)component of accumulated 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 rigid block orientation can be visualized.
 eulerx (3D ONLY)
The \(x\)euler angle (in degrees) of the current rigid block orientation. See the euler keyword for further details.
 eulery (3D ONLY)
The \(y\)euler angle (in degrees) of the current rigid block orientation. See the euler keyword for further details.
 eulerz (3D ONLY)
The \(z\)euler angle (in degrees) of the current rigid block orientation. See the euler keyword for further details.
 forceapplied
Force vector applied to rigid blocks.
 forceappliedx
The \(x\)component of the applied force.
 forceappliedy
The \(y\)component of the applied force.
 forceappliedz (3D ONLY)
The \(z\)component of the applied force.
 forcecontact
Sum of the contact force accumulated to the rigid blocks 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”).
 moi11
11 component of the rigid block real moment of inertia.
 moi12
12 component of the rigid block real moment of inertia.
 moi13
13 component of the rigid block real moment of inertia.
 moi22
22 component of the rigid block real moment of inertia.
 moi23
23 component of the rigid block real moment of inertia.
 moi33
33 component of the rigid block real moment of inertia.
 moiprincipal (3D ONLY)
Real principal moments of inertia.
 momentapplied
Moment applied to rigid blocks.
 momentappliedx (3D ONLY)
The \(x\)component of the moment applied to rigid blocks.
 momentappliedy (3D ONLY)
The \(y\)component of the moment applied to rigid blocks.
 momentappliedz (3D ONLY)
The \(z\)component of the moment applied to rigid blocks.
 momentcontact
Sum of the contact moments accumulated to the rigid blocks 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 rigid block centroid.
 positionx
The \(x\)component of the location of rigid block centroids.
 positiony
The \(y\)component of the location of rigid block centroids.
 positionz
The \(z\)component of the location of rigid block centroids.
 rotation (2D ONLY)
Current rigid block orientation. The orientation is updated only when orientation tracking has been enabled (see
model orientationtracking
command).
 spin
Rigid block angular velocity in radians per second.
 spinx (3D ONLY)
The \(x\)component of the rigid block angular velocity in radians per second.
 spiny (3D ONLY)
The \(y\)component of the rigid block angular velocity in radians per second.
 spinz (3D ONLY)
The \(z\)component of the rigid block angular velocity in radians per second.
 velocity
Rigid block translational velocity vector.
 velocityx
The \(x\)component of the rigid block velocity.
 velocityy
The \(y\)component of the rigid block velocity.
 velocityz (3D ONLY)
The \(z\)component of the rigid block velocity.
 volume
Rigid block volume.
 contact <all>
List the contacts with a rigid block. The rigid block ID, 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 rigid block properties. If no s is given, then the available properties are listed for each rigid block.
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 rigid block model results that have been tabulated. See the
rblock results
command for more details.
 Use the
Usage Example
List the value of the rigid block extra variable stored at index position 1
.
rblock list extra 1
List the centroid location of all rigid blocks.
rblock list attribute position
List the contact model property designated by kn
(normal stiffness) for all rigid blocks.
rblock list prop 'kn'
Was this helpful? ...  PFC © 2021, Itasca  Updated: Feb 25, 2024 