Homec4science
Diffusion lammps (lammm-master) Browse

lammps/doc/restart.txt
1138cacffd62lammm-master

Last Change
Raw File

restart.txt
View Options

"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
:link(lws,http://lammps.sandia.gov)
:link(ld,Manual.html)
:link(lc,Section_commands.html#comm)
:line
restart command :h3
[Syntax:]
restart 0
restart N root
restart N file1 file2 :pre
N = write a restart file every this many timesteps
root = filename to which timestep # is appended
file1,file2 = two full filenames, toggle between them when writing file :ul
[Examples:]
restart 0
restart 1000 poly.restart
restart 1000 restart.*.equil
restart 10000 poly.%.1 poly.%.2 :pre
[Description:]
Write out a binary restart file every so many timesteps as a run
proceeds. A value of 0 means do not write out restart files. Using
one filename as an argument will create a series of filenames which
include the timestep in the filename. Using two filenames will
produce only 2 restart files. LAMMPS will toggle between the 2 names
as it writes successive restart files.
Similar to "dump"_dump.html files, the restart filename(s) can contain
two wild-card characters. If a "*" appears in the filename, it is
replaced with the current timestep value. This is only recognized
when a single filename is used (not when toggling back and forth).
Thus, the 3rd example above creates restart files as follows:
restart.1000.equil, restart.2000.equil, etc. If a single filename is
used with no "*", then the timestep value is appended. E.g. the 2nd
example above creates restart files as follows: poly.restart.1000,
poly.restart.2000, etc.
If a "%" character appears in the restart filename(s), then one file
is written for each processor and the "%" character is replaced with
the processor ID from 0 to P-1. An additional file with the "%"
replaced by "base" is also written, which contains global information.
For example, the files written on step 1000 for filename restart.%
would be restart.base.1000, restart.0.1000, restart.1.1000, ...,
restart.P-1.1000. This creates smaller files and can be a fast mode
of output on parallel machines that support parallel I/O for output.
Restart files are written on timesteps that are a multiple of N but
not on the first timestep of a run or minimization. A restart file is
not written on the last timestep of a run unless it is a multiple of
N. A restart file is written on the last timestep of a minimization
if N > 0 and the minimization converges.
See the "read_restart"_read_restart.html command for information about
what is stored in a restart file.
Restart files can be read by a "read_restart"_read_restart.html
command to restart a simulation from a particular state. Because the
file is binary (to enable exact restarts), it may not be readable on
another machine. In this case, the "restart2data
program"_Section_tools.html#restart in the tools directory can be used
to convert a restart file to an ASCII data file. Both the
read_restart command and restart2data tool can read in a restart file
that was written with the "%" character so that multiple files were
created.
[Restrictions:] none
[Related commands:]
"write_restart"_write_restart.html, "read_restart"_read_restart.html
[Default:]
restart 0 :pre
c4science · Help