Main Help → All Commands → MPM Archiving / Explicit Cracks → ToArchive
In MPM calculations, the solution is stored in a series of archive files. These files give all the current calculation results for each material point. These files are read latter to plot the results. The Archive Command selects where and how often the files are saved. The ToArchive
command described here selects which analysis results are saved in those archived files:
ToArchive (data1),(data2),...
where any number of parameters specify which data to archive by name. You can put all options in a single ToArchive
command or put them in multiple ToArchive
commands. The archiving options, which are case insensitive, are:
velocity
- particle velocitiesstress
- particle stressstrain
- particle total strain, which in combination with rotstrain
gives full deformation gradient.plasticstrain
- an alternate particle strain (some materials provide plastic strains; others provide other data)rotstrain
- particle initial material rotation angles. Archiving this result is needed to plot transformed material points and it is now automatically activated whenever strain
is archived (which means full deformation gradient is archived)strainenergy
- particle strain energy, which is cumulative σ.d(ε-εres)plasticenergy
- cumulative dissipated energylp
- angular momentum due to particle spin (zero unless particle spin is activated)wp
- angular velocity due to particle spin (zero unless particle spin is activated)workenergy
- particle work energy, which is cumulative σ.dεheatenergy
- cumulative heat energy on the particle (only valid if all materials have specified their heat capacity).temperature
- particle temperatureconcentration
or porepressure
- particle concentration and concentration gradients (when doing diffusion calculations) or pore pressure and pore pressure gradients< (when doing poroelasticity calculations).history#
- where '#' is 1 to 19 to archive that history variable for a material. These history variables depend on the type of materials being used.damagenormal
- vector normal to damage plane in softening materials.size
- particle sizes. The main use is to allow ExtractMPM to export an VTK file with an unstructured grid (-U option)to improve visualization in other software.elementcrossings
- number of times the particle has crossed an element boundary since the last archive time.The follow options are for crack particles:
jintegral
- crack tip J1 and J2 integralsstressintensity
- crack tip KI and KIIczmdisp
- mode I and II energy dissipated by cohesive zones. Needed to be able to plot cohesive zone damage length or energy dissipations terms.traction#
- where '#' is 1 to 10 to archive that cohesive zone history variable along cracks. These traction history variables depend on traction laws being used.Certain material point results are always archived and thus there is no need to specify them in a ToArchive
command. The standard archived data are:
mass
- particle massmaterial ID
- material ID number for particlematerial angle
- small strain material angle (stored in degrees) (it is used with rotstrain
to calculate rotational strain and deformation gradient)thickness
- thickness for 2D calculationsposition
- current particle positionoriginal position
- initial position for displacement calculationscrack position
- crack particle positionscrack original position
- initial crack particle positionscrack surface positions
- location of crack surfacesToArchive
command, it will archive default properties, stress, strain, and velocity. If ToArchive
commands are used, the default stress, strain, and velocity will be replaced by all options in those commands.ToArchive
command is only allowed for MPM analyses.