MPM Archiving Options

These commands determine the way results of the calculations are archived for later analysis.

Archiving Particle Data

In MPM calculations, the calculation results are stored in a series of archive files. These files give periodic snapshots for the state of each material point. These files are read after the analysis to plot the results; in fact the results cannot be visualized without them.

Scripted Input Files

In scripted input files, the archiving options have two forms:

Archive (path)
ArchiveTime (time),<(first time)>
ToArchive (list on quantities)

or

ArchiveUnique (path)
ArchiveTime (time),<(first time)>
ToArchive (list on quantities)

where

• (path) gives a relative path name from the saved output file to the archived files. The path name should be entered in Unix style or

  folder/folder/folder/root

  where there can be any number of folders followed by the root archive file name. The saved files will be in that location and have names

  root.num

  where num is the step number being archived. The folder names and root name cannot contain any colons (":"), to avoid conflict with MacOS path names) or spaces (to be consistent with most Unix systems).
     If a series MPM calculations are saved to the same folder without changing the archive path name, the later calculations will most likely overwrite the earlier calculations causing you to lose results. The solution is to use the second form above that replaces the Archive command with an ArchiveUnique command. The ArchiveUnique command forces creation of a new folder within the last folder of the path. In the above path example, the ArchiveUnique option will write to the files:

  folder/folder/folder/#/root.num

  where # is chosen from 1, 2, 3, ... to create a unique folder. You can then safely write multiple MPM output files to the save folder without conflicts

• (time) gives the time interval between archiving results in milliseconds (it can be an entity). The analysis will always archive the initial state (to define the problem). You only need to archive enough results to get good plots or movies after the analysis is done.
• (first time) is an optional time to start archiving in milliseconds (it can be an entity). If this time is greater than zero, the analysis will archive the initial state (to define the problem) and not archive anymore more results until this time is reached. After this time, archiving will proceed at the time interval specified in (time).
• (list on quantities) is a comma-separted list of quantities to be archived (see ToArchive command for the details.

ToArchive Command

The ToArchive command determines which calculation results to include in archived results by providing a comma-separated list of the following options (which can be in one or more ToArchive commands and are case sensitive):

• velocity - particle velocities
• stress - particle stress
• strain - particle strain, which is elastic strain for plasticity materials
• plasticstrain - particle plastic strain
• strainenergy - particle strain energy
• plasticenergy - cumulative dissipated energy
• externalwork - cumulative work done on a particle be external forces
• temperature - particle temperature
• concentration - particle concentration and concentration gradients
• shearcomponents - separate components of total shear strain (namely u/y and v/x; these sum to total shear strain)
• jintegral - crack tip J1 and J2 integrals
• stressintensity - crack tip KI and KII
• energybalance - energy balance results during <a href="propagate.html">crack growth by energy balance</a>.
• history# - where '#' is 1 to 4 to archive that history variable for a material. This history variable is only relevant for certain types of materials.
• thermalenergy - approximate particle thermal energy (ρ C_p ΔT²/(2 T₀) where T₀ is the stress free temperature) - only meaningful when doing conduction calculations and only accurate when the temperature changes are small.
• elementcrossings - number of times the particle has crossed an element boundary since the last archive time.
• rotstrain - rotational strain. Archiving this strain is needed to plot transformed material points.

Certain particle results are always archived and thus there is no need to specify them in a ToArchive command. The standard archived data are:

• mass - particle mass
• material ID - material ID number for particle
• material angle - material axis angle for anisotropic materials
• thickness - thickness for 2D calculations
• position - current particle position
• original position - initial position for displacement calculations
• crack position - crack particle positions
• crack original position - initial crack particle positions
• crack surface positions - location of crack surfaces

Finally, note that if no ToArchive command is used in an input file, the default archived quantities will be equivalent to the commands:

ToArchive velocity,stress,strain,plasticstrain
ToArchive plasticenergy,externalwork,temperature

But if one or more ToArchive commands are used, you have to specify all quantities you want (i.e., the default ones are not automatically included).

XML Input Files

In XML input files, the archiving commands, which must be within the single <MPMHeader> element are:

<ArchiveTime units='ms'>2</ArchiveTime>
<FirstArchiveTime units='ms'>100</FirstArchiveTime>
<ArchiveRoot unique='0'>results/fullDCB/root.</ArchiveRoot>
<MPMArchiveOrder>mYYYYNYYYNYYNNNNNY</MPMArchiveOrder>
<CrackArchiveOrder>mYYYN</CrackArchiveOrder>

Global Archiving Options

• GlobalArchive Command
• GlobalArchiveTime Command