contact history
command
Syntax
- contact history <id id > s keyword ...
Primary keywords:
force force-x force-y force-z gap localforce-y localforce-z localmomenton1-x localmomenton1-y localmomenton1-z localmomenton2-x localmomenton2-y localmomenton2-z mechanical momenton1 momenton1-x momenton1-y momenton1-z momenton2 momenton2-x momenton2-y momenton2-z normalforce position-x position-y position-z shearforce thermal
Add a contact history. A history is a floating point variable that can be sampled and stored during a model run. The optional id directly following history creates a history with the specified ID. 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. See the
contact history
command for details regarding the manipulation of histories.By default, only mechanical contacts 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.
- localforce-x
The \(x\)-component of the contact force in the contact coordinate system.
- localforce-y
The \(y\)-component of the contact force in the contact coordinate system.
- localforce-z (3D ONLY)
The \(z\)-component of the contact force in the contact coordinate system.
- localmomenton1-x (3D ONLY)
The \(x\)-component of the contact moment on end 1 in the contact coordinate system.
- localmomenton1-y (3D ONLY)
The \(y\)-component of the contact moment on end 1 in the contact coordinate system.
- localmomenton1-z (3D ONLY)
The \(z\)-component of the contact moment on end 1 in the contact coordinate system.
- localmomenton2-x (3D ONLY)
The \(x\)-component of the contact moment on end 2 in the contact coordinate system.
- localmomenton2-y (3D ONLY)
The \(y\)-component of the contact moment on end 2 in the contact coordinate system.
- localmomenton2-z (3D ONLY)
The \(z\)-component of the contact moment on end 2 in the contact coordinate system.
- mechanical
Apply to mechanical contacts.
- momenton1
The {contact moment on end 1 in 2D; magnitude of the contact moment on end 1 in 3D}.
- momenton1-x (3D ONLY)
The \(x\)-component of the contact moment on end 1.
- momenton1-y (3D ONLY)
The \(y\)-component of the contact moment on end 1.
- momenton1-z (3D ONLY)
The \(z\)-component of the contact moment on end 1.
- momenton2
The {contact moment on end 2 in 2D; magnitude of the contact moment on end 2 in 3D}.
- momenton2-x (3D ONLY)
The \(x\)-component of the contact moment on end 2.
- momenton2-y (3D ONLY)
The \(y\)-component of the contact moment on end 2.
- momenton2-z (3D ONLY)
The \(z\)-component of the contact moment on end 2.
- normalforce
Contact force in the normal direction.
- 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.
- shearforce
Magnitude of the shear contact force.
- thermal
Apply to thermal contacts.
Usage Example
contact history ball-ball force-x id 1
contact history ball-ball force id 1
Was this helpful? ... | PFC © 2021, Itasca | Updated: Feb 25, 2024 |