Main Help → All Commands → MPM Archiving → GlobalArchive
In MPM calculations, the solution is stored in a series of archive files (see Archive Command). You can optionally create a global results file which will store a collection of calculated results such as average stress, total energy, etc., in a single file. The file is tab delimited with the time (in alt time units) in the first column and all requested results in subsequent columns. This file can be opened later and plotted by this software or by any spread-sheet software. The GlobalArchive
and GlobalArchiveTime
commands selects which analysis results are saved in the global results file and how often they are saved:
GlobalArchive (quantity),<(mat)> GlobalArchive (quantity),(x),(y),<(z)> GlobalArchiveTime <(time)>
where
(quantity)
is the global quantity to be save in the global results file (see below)(mat)
is the material ID for a previously defined material. Most of the global quantities are averaged over particles. You can specify this optional second parameter with a material ID and the average will be only for particles of that material type. Omit (mat)
to indicate an average over all particles. Most quantities on the grid (e.g., "Grid Kinetic Energy" but not "reactionx(y,z,R,Z)" or "contactx(y,z,R,Z)") will ignore the material ID.(x),(y),(z)
define the location of a tracer particle. Whatever particle quantity is selected will be output to the global archive file for the single particle whose initial position is closest to the provided coordinates. The (z)
value can omitted for 2D simulations; enter R-Z coordinates in (x),(y)
for axisymmetric simulations.(time)
is the time interval for storing global results in alt time units (it can be an entity that give time in time units). If the time interval is never specified, it will be set to archiving interval specified in the Archive command. Specifying another time lets these two archiving times be different if desired.The global archiving quantities, listed by category are:
sxx
, syy
, szz
, sxy
, sxz
, or syz
- average element of the stress tensor in pressure unitssRR
, sZZ
, sTT
, or sRZ
- average element of the axisymmetric stress tensor in pressure units (synonyms for sxx
, syy
, szz
, and sxy
)exx
, eyy
, ezz
, exy
, exz
, or eyz
- average element of the total Biot strain tensor in %.eRR
, eZZ
, eTT
, or eRZ
- average element of the axisymmetric total Biot strain tensor % (synonyms for exx
, eyy
, ezz
, and exy
)exxe
, eyye
, ezze
, exye
, exze
, or eyze
- average element of the elastic Biot strain tensor in %, which is total
Biot strain minus plastic Biot strain for plasticity materials.eRRe
, eZZe
, eTTe
, or eRZe
- average element of the axisymmetric elastic Biot strain tensor % (synonyms for exxe
, eyye
, ezze
, and exye
)exxp
, eyyp
, ezzp
, exyp
, exzp
, or eyzp
- average element of the plastic Biot strain tensor in %eRRp
, eZZp
, eTTp
, or eRZp
- average element of the axisymmetric plastic Biot strain tensor in % (synonyms for exxp
, eyyp
, ezzp
, and exyp
)Fij
(where i
and j
are x
, y
, or z
) - any component of the total deformation gradient (absolute)Fij
(where i
and j
are R
or Z
) - any component of the total axisymmetric deformation gradient (absolute, synonyms for the x
or y
) versions.velx
, vely
, or velz
- average component of velocity in velocity unitsvelR
or velZ
- average component of axisymmetric velocity in velocity units (synonyms for velx
or vely
)dispx
, dispy
, or dispz
- average component of displacement in length unitsdispR
or dispZ
- average component of axisymmetric displacement in length units (synonyms for dispx
or dispy
)px
, py
, or pz
- average component of momentum (in linear momentum units)pR
or pR
- average component of axisymmetric momentum (in linear momentum units) (synonyms for px
or py
)Lx
, Ly
, or Lz
- average component of angular momentum (in angular momentum units) (note that only Lz is non-zero in 2D or axisymmetric calculations).Lpx
, Lpy
, or Lpz
- average component of particle spin angular momentum (in angular momentum units) (note that only Lpz is non-zero in 2D or axisymmetric calculations and the simulation must be tracking particle spin for any component to be non zero).wpx
, wpy
, or wpz
- average component of particle spin velocity (in 1/time units) (note that only wpz is non-zero in 2D or axisymmetric calculations and the simulation must be tracking particle spin for any component to be non zero).contactx
, contacty
, or contactz
- component of the total contact force on the grid for multimaterial mode simulations when they include rigid materials that have direction=8
. It is a sum of all contact forces for the rigid material on the object in force units.contactR
or contactZ
- component of the total contact force per radian on the axisymmetric grid in force units (synonyms for contactx
or contacty
)reactionx
, reactiony
, or reactionz
- component of the reaction force at nodes with velocity boundary conditions in force units. If (mat)
specifies a material, the force will be for all velocity conditions created by that rigid material; if(mat)
is omitted the force will sum all velocity boundary conditions (specified or created by rigid particles); if (mat)
< 0, the force will be only for velocity boundary conditions with that boundary condition ID.
When the ExtrapolateRigid option is used, set (material)
to -40 to get reaction force for all rigid materials (and in this mode it is not possible to separate forces on different rigid materials).reactionR
or reactionZ
- component of the reaction force per radian at axisymmetric nodes with velocity boundary conditions in force units (synonyms for reactionx
or reactiony
and see them for meaning of #2)temp
- average temperature (in K)Heat Energy
- total heat energy in energy unitsheatWatts
- the heating force at nodes with velocity boundary conditions in energy units/time units. If (mat)
specifies a material, the heating rate will be for all temperature conditions created by that rigid material; if(mat)
is omitted the heating rate will sum all temperature boundary conditions (specified or created by rigid particles); if (mat)
< 0, the heating rate will be only for temperature boundary conditions with that boundary condition ID.Friction Work
- total friction work converted into heat in energy units.Work Energy
- total work energy in energy units, which is cumulative σ.dεStrain Energy
- total strain energy in energy units, which is cumulative σ.d(ε-εres)Kinetic Energy
- total kinetic energy in energy units on the particlesGrid Kinetic Energy
- total kinetic energy in energy units on the gridHeat Energy
- total heat energy in energy unitsEntropy
- total entropy in energy units/KInternal Energy
- sum of work and heat energy (U = w +q) in energy unitsHelmholz Energy
- total Helmholz free energy (A = U - TS) in energy unitsInterface Energy
- total energy associated with cracks having imperfect interfaces in energy units.Plastic Energy
- total dissipated energy in energy unitsalpha
- the total grid damping coefficient, αg, which evolves when using feedback damping and may depend on time when using simple damping (in 1/time units)palpha
- the total particle damping coefficient, αp, which evolves when using feedback damping and may depend on time when using simple damping (in 1/time units)Decohesion
- This quantity will result in a second global archive file (with extension .decohn) that will have a tab-delimited list of information about particle decohesions when using softening materials. Without this option, decohesion information is written to the main output file. With this option, all that output is diverted to a file and it includes some additional information. It is most useful in 3D simulations with lots of decohesion.concentration
or porepressure
- weight fraction concentration (when doing diffusion calculations) or pore pressure (when doing poroelasticity calculations) in pressure units.Step number
- the current MPM step numberElapsed time
- elapsed clock time for the current calculation (in secs)CPU time
- total CPU time for the current calculation (in secs)Note: when global archiving of strains, they are calculated as a Biot strain in the current configuration. The Biot strain is defined is V-I where V is the left-stretch tensor. This strain is also the Seth-Hill strain with m=1/2 in current configuration. For small strain problems it is equivalent to the small strain tensor.
GlobalArchive
commands, but only one option can be in each command.GlobalArchive
and GlobalArchiveTime
commands are only allowed for MPM analyses.