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 precisioncommand 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.
- displacement-x
The \(x\)-component of the accumulated rigid block 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 (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 orientation-trackingcommand). When active, the current rigid block orientation can be visualized.
- euler-x (3D ONLY)
The \(x\)-euler angle (in degrees) of the current rigid block orientation. See the euler keyword for further details.
- euler-y (3D ONLY)
The \(y\)-euler angle (in degrees) of the current rigid block orientation. See the euler keyword for further details.
- euler-z (3D ONLY)
The \(z\)-euler angle (in degrees) of the current rigid block orientation. See the euler keyword for further details.
- force-applied
Force vector applied to rigid blocks.
- force-applied-x
The \(x\)-component of the applied force.
- force-applied-y
The \(y\)-component of the applied force.
- force-applied-z (3D ONLY)
The \(z\)-component of the applied force.
- force-contact
Sum of the contact force accumulated to the rigid blocks during the previous force-displacement update. This value will be modified during the next force-displacement update.
- 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.
- fragment
Fragment ID (see “Fragment”).
- moi-11
11 component of the rigid block real moment of inertia.
- moi-12
12 component of the rigid block real moment of inertia.
- moi-13
13 component of the rigid block real moment of inertia.
- moi-22
22 component of the rigid block real moment of inertia.
- moi-23
23 component of the rigid block real moment of inertia.
- moi-33
33 component of the rigid block real moment of inertia.
- moi-principal (3D ONLY)
Real principal moments of inertia.
- moment-applied
Moment applied to rigid blocks.
- moment-applied-x (3D ONLY)
The \(x\)-component of the moment applied to rigid blocks.
- moment-applied-y (3D ONLY)
The \(y\)-component of the moment applied to rigid blocks.
- moment-applied-z (3D ONLY)
The \(z\)-component of the moment applied to rigid blocks.
- moment-contact
Sum of the contact moments accumulated to the rigid blocks during the previous force-displacement update. This value will be modified during the next force-displacement update.
- 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.
- position
Location of rigid block centroid.
- position-x
The \(x\)-component of the location of rigid block centroids.
- position-y
The \(y\)-component of the location of rigid block centroids.
- position-z
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 orientation-trackingcommand).
- spin
Rigid block angular velocity in radians per second.
- spin-x (3D ONLY)
The \(x\)-component of the rigid block angular velocity in radians per second.
- spin-y (3D ONLY)
The \(y\)-component of the rigid block angular velocity in radians per second.
- spin-z (3D ONLY)
The \(z\)-component of the rigid block angular velocity in radians per second.
- velocity
Rigid block translational velocity vector.
- velocity-x
The \(x\)-component of the rigid block velocity.
- velocity-y
The \(y\)-component of the rigid block velocity.
- velocity-z (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 resultscommand 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 |