Main Help → All Commands → MPM Archiving → Archive
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 required to post-analysis visualization. The Archive
command determines where the archive files are saved and how often they are saved:
Archive (path) ArchiveTime (time),<(first)>,<(props)> <ArchiveTime (time2),<(first2)>,<(props2)>> <ArchiveTime (time3),<(first3)>,<(props3)>>
or
ArchiveUnique (path) ArchiveTime (time),<(first)>,<(props)> <ArchiveTime (time2),<(first2)>,<(props2)>> <ArchiveTime (time3),<(first3)>,<(props3)>>
where
(path)
gives a relative path name from the saved output file to the archive files. The path name should be entered in Unix style or
folder/folder/folder/rootwhere 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.numwhere 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).
Archive
command with an ArchiveUnique
command. The ArchiveUnique
command forces creation of a new folder within the last folder of the path. With this option, new results are always in a new folder. In the above path example, the ArchiveUnique
option will write to the files
folder/folder/folder/#/root.numwhere
#
is chosen from 1, 2, 3, ... 999, to create a new folder. You can then safely write multiple MPM output files to the save folder without conflicts, although if the same results are run many times during commands develop, unique archiving of large calculations may start to fill up your disk.
(time)
gives the time interval between archiving results in alt time units (it can be an entity that gives time in time units).(first)
is an optional time to start archiving in alt time units (it can be an entity that give time in time units). After this time, archiving will proceed at the time interval specified in (time)
.(props)
forces archiving if (props)
propagations and/or debonds have occurred since the last archive (default is 0, which disables counting of propagations).A single ArchiveTime
command is usually enough, but sometimes you want to archive infrequently at the beginning and then more frequently later or to archive by some other custom scheme. To create custom archiving schemes, you create archiving blocks with multiple ArchiveTime
commands. Each subsequent command adds a new block that archives with new (time) and (props) settings in the first and optional third arguments. The new block starts at the time given in the second parameter, which is now a required parameter and it must be a later time than the start of the previous archiving block.
(time)
and (first)
can alternatively be supplied as optional parameters in an Archive (path),<(time)>,<(first)>
command or a ArchiveUnique (path),<(time)>,<(first)>
command to define the root folder and archiving times in a single command.Archive
and ArchiveTime
commands are only allowed for MPM analyses.