contact history command

Syntax

contact <sprocess> history <name isid > s keyword ...

Primary keywords:

force    force-x    force-y    force-z    gap    force-local-x    force-local-y    force-local-z    force-normal    force-shear    moment-on1    moment-on1-local-x    moment-on1-local-y    moment-on1-local-z    moment-on1-x    moment-on1-y    moment-on1-z    moment-on2    moment-on2-local-x    moment-on2-local-y    moment-on2-local-z    moment-on2-x    moment-on2-y    moment-on2-z    position-x    position-y    position-z

Add a contact history. A history is a floating point variable that can be sampled and stored during a model run. The optional sid directly following name keyword creates a history with the specified name. If not specified, then the next available history ID is used. The s value identifies the contact type (i.e., ball-ball, ball-pebble, ball-facet, or pebble-facet). Following one of the keywords given below, either 1) a position vector or 2) an additional id keyword must be given to define the specific contact. Review the common history commands for details regarding the manipulation of histories.

By default, only mechanical contacts are considered. If sprocess is specified, then it must correspond to a process name and contacts within this process are considered.

force

Magnitude of the contact force.

force-x

The x-component of the contact force.

force-y

The y-component of the contact force.

force-z (3D ONLY)

The z-component of the contact force.

gap

Contact gap.

force-local-x

The x-component of the contact force in the contact coordinate system.

force-local-y

The y-component of the contact force in the contact coordinate system.

force-local-z (3D ONLY)

The z-component of the contact force in the contact coordinate system.

force-normal

Contact force in the normal direction.

force-shear

Magnitude of the shear contact force.

moment-on1

The {contact moment on end 1 in 2D; magnitude of the contact moment on end 1 in 3D}.

moment-on1-local-x (3D ONLY)

The x-component of the contact moment on end 1 in the contact coordinate system.

moment-on1-local-y (3D ONLY)

The y-component of the contact moment on end 1 in the contact coordinate system.

moment-on1-local-z (3D ONLY)

The z-component of the contact moment on end 1 in the contact coordinate system.

moment-on1-x (3D ONLY)

The x-component of the contact moment on end 1.

moment-on1-y (3D ONLY)

The y-component of the contact moment on end 1.

moment-on1-z (3D ONLY)

The z-component of the contact moment on end 1.

moment-on2

The {contact moment on end 2 in 2D; magnitude of the contact moment on end 2 in 3D}.

moment-on2-local-x (3D ONLY)

The x-component of the contact moment on end 2 in the contact coordinate system.

moment-on2-local-y (3D ONLY)

The y-component of the contact moment on end 2 in the contact coordinate system.

moment-on2-local-z (3D ONLY)

The z-component of the contact moment on end 2 in the contact coordinate system.

moment-on2-x (3D ONLY)

The x-component of the contact moment on end 2.

moment-on2-y (3D ONLY)

The y-component of the contact moment on end 2.

moment-on2-z (3D ONLY)

The z-component of the contact moment on end 2.

position-x

The x-component of the contact position.

position-y

The y-component of the contact position.

position-z (3D ONLY)

The z-component of the contact position.