# model history command

Syntax

model history <name s > keyword

Primary keywords:

Create a history of a model quantity. These quantities are mostly associated with a process.

The keyword name may be used to give the history a unique identifier for later reference. If name is not specified the history will be given a name automatically based on the internally assigned ID number.

The following keywords apply:

creep keyword

Values associated with the creep process.

cycles-total

The total number of cycles accumulated while this process is active.

time-total

The total accumulated time while this process is active.

damping

Value of global damping parameter (3DEC)

dynamic keyword

Values associated with the dynamic process.

cycles-total

The total number of cycles accumulated while this process is active.

time-total

The total accumulated time while this process is active.

energy keyword

Values associated with energy quantities in 3DEC.

block-kinetic

The kinetic energy value in 3DEC.

block-potential

The potential energy value in 3DEC.

block-strain

The block strain in 3DEC.

block-strain-excavated

The excavated block strain in 3DEC.

block-strain-fill

The fill strain value in 3DEC.

block-strain-plastic

The plastic strain value in 3DEC.

block-volume-excavated

The excavated block volume in 3DEC.

The boundary load in 3DEC.

boundary-viscous

The boundary viscous force in 3DEC.

damp-mass

The mass damping value in 3DEC.

joint-friction

The joint friction value in 3DEC.

joint-strain

The joint strain value in 3DEC.

joint-strain-compressive

The joint compressive strain value in 3DEC.

joint-strain-excavated

The joint strain excavated value in 3DEC.

joint-strain-shear

The joint strain shear value in 3DEC.

joint-strain-tensile

The joint strain tensile value in 3DEC.

strain-excavated

The excavated strain value in 3DEC.

strain-total

The total strain value in 3DEC (joints + zones).

total-released

The total released energy value in 3DEC.

total-stored

The stored energy value in 3DEC.

fluid keyword

Values associated with the fluid process.

cycles-total

The total number of cycles accumulated while this process is active.

time-total

The total accumulated time while this process is active.

mechanical keyword

Values associated with the mechanical process.

convergence

The current mechanical value of convergence (see model solve mechanical convergence).

cycle

The total number of mechanical cycles. (Deprecated; use cycles-total.)

cycles

The number of cycles this process has taken in this model solve command.

cycles-total

The total number of cycles accumulated while this process is active.

energy keyword

The value of an energy partition in PFC.

Adhesive energy stored contacts.

energy-body

Body based work energy.

energy-boundary

Wall based work energy.

energy-damp

Local damping energy of bodies.

energy-dashpot

Viscous dashpot energy stored in contacts.

energy-kinetic

Kinetic energy of bodies.

energy-pbstrain

Parallel bond strain energy stored in contacts.

energy-rrslip

Rolling resistance slip energy stored in contacts.

energy-rrstrain

Rolling resistance strain energy stored in contacts.

energy-slip

Slip energy stored in contacts.

energy-strain

Strain energy stored in contacts.

ratio

The value of the ratio currently being used. See the definition of ratios in ref-equilibrium-. this and and next three need to be checked with DR closer to release!!!!

ratio-average

The value of the average force ratio. See the definition of ratios in ref-equilibrium-.

ratio-local

The value of the local force ratio. See the definition of ratios in ref-equilibrium-.

ratio-maximum

The value of the maximum force ratio. See the definition of ratios in ref-equilibrium-.

time

The accumulated time this process has done in this model solve command.

time-total

The total accumulated time while this process is active.

unbalanced-average

The average unbalanced force over all objects.

unbalanced-maximum

The maximum unbalanced force in any object.

thermal

Values associated with the thermal process.

cycles-total

The total number of cycles accumulated while this process is active.

time-total

The total accumulated time while this process is active.

timestep

The active timestep.