clump list command

Syntax

clump list <keyword> <range>

Primary keywords:

attribute    contact    extra    group    property    result    template

List clump information. By default, the clump ID, template name, pebble count, active/total contact count, fixity, and position are listed. Use the attribute keyword to list all clump ball attributes that can be listed.

Note

  • Use the model precision command to change the precision of listed floating point values.
  • The optional range always applies to clumps and not pebbles.
attribute <keyword>

List clump 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 clump. Pebble attributes, such as pebble position, also may be present.

Attributes are characteristics of clumps such as mass and velocity. These are distinct from properties that represent surface conditions and are used in contact models to delineate interactions.

contact <all>

List the contacts with a clump. The pebble 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 <pebble>

List the extra variables at index i. If the pebble keyword is given, then the pebble extra variables at index i are listed.

group s <pebble>

List the group names at slot s. If the pebble keyword is given, then the pebble group variables at slot s are listed.

property <s >

List pebble properties. If no s is given, then the available properties are listed for each clump (i.e., the list of properties over all pebbles in the clump). If s is specified, then the value of that property is listed for each pebble.

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 clump model results that have been tabulated. See the clump results command for more details.

template <attribute s >

List information regarding clump templates, including the clump template name, referenced status, pebble count, volume, and density. The attribute kewyord without s lists the available attributes. If s is specified, then the value of that attribute is listed for each clump template.