rblock list command

Syntax

rblock list <keyword> <range>

Primary keywords:

attribute    contact    extra    group    property    result    template

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.

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-tracking command). 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-tracking command).

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.

extra i

List the extra variables at index i.

group slot

List the group names at slot slot.

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.

template <attribute s >

List information regarding rigid block templates, including the rigid block template name, volume, and density. The attribute keyword without s lists the available attributes. If s is specified, then the value of that attribute is listed for each template.

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'