forked from lijiext/lammps
125 lines
5.0 KiB
HTML
125 lines
5.0 KiB
HTML
<HTML>
|
|
<CENTER><A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LAMMPS Documentation</A> - <A HREF = "Section_commands.html#comm">LAMMPS Commands</A>
|
|
</CENTER>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<HR>
|
|
|
|
<H3>restart command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>restart 0
|
|
restart N root
|
|
restart N file1 file2
|
|
</PRE>
|
|
<UL><LI>N = write a restart file every this many timesteps
|
|
<LI>N can be a variable (see below)
|
|
<LI>root = filename to which timestep # is appended
|
|
<LI>file1,file2 = two full filenames, toggle between them when writing file
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>restart 0
|
|
restart 1000 poly.restart
|
|
restart 1000 restart.*.equil
|
|
restart 10000 poly.%.1 poly.%.2
|
|
restart v_mystep poly.restart
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Write out a binary restart file every so many timesteps, in either or
|
|
both of two modes, as a run proceeds. A value of 0 means do not write
|
|
out any restart files. The two modes are as follows. If one filename
|
|
is specified, a series of filenames will be created which include the
|
|
timestep in the filename. If two filenames are specified, only 2
|
|
restart files will be created, with those names. LAMMPS will toggle
|
|
between the 2 names as it writes successive restart files.
|
|
</P>
|
|
<P>Note that you can specify the restart command twice, once with a
|
|
single filename and once with two filenames. This would allow you,
|
|
for example, to write out archival restart files every 100000 steps
|
|
using a single filenname, and more frequent temporary restart files
|
|
every 1000 steps, using two filenames. Using restart 0 will turn off
|
|
both modes of output.
|
|
</P>
|
|
<P>Similar to <A HREF = "dump.html">dump</A> files, the restart filename(s) can contain
|
|
two wild-card characters.
|
|
</P>
|
|
<P>If a "*" appears in the single 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.
|
|
</P>
|
|
<P>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 and subsequent input on parallel machines that support
|
|
parallel I/O.
|
|
</P>
|
|
<P>Restart files are written on timesteps that are a multiple of N but
|
|
not on the first timestep of a run or minimization. You can use the
|
|
<A HREF = "write_restart.html">write_restart</A> command to write a restart file
|
|
before a run begins. 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.
|
|
</P>
|
|
<P>Instead of a numeric value, N can be specifed as an <A HREF = "variable.html">equal-style
|
|
variable</A>, which should be specified as v_name, where
|
|
name is the variable name. In this case, the variable is evaluated at
|
|
the beginning of a run to determine the next timestep at which a
|
|
restart file will be written out. On that timestep, the variable will
|
|
be evaluated again to determine the next timestep, etc. Thus the
|
|
variable should return timestep values. See the stagger() and
|
|
logfreq() and stride() math functions for <A HREF = "variable.html">equal-style
|
|
variables</A>, as examples of useful functions to use in
|
|
this context. Other similar math functions could easily be added as
|
|
options for <A HREF = "variable.html">equal-style variables</A>.
|
|
</P>
|
|
<P>For example, the following commands will write restart files
|
|
every step from 1100 to 1200, and could be useful for debugging
|
|
a simulation where something goes wrong at step 1163:
|
|
</P>
|
|
<PRE>variable s equal stride(1100,1200,1)
|
|
restart v_s tmp.restart
|
|
</PRE>
|
|
<HR>
|
|
|
|
<P>See the <A HREF = "read_restart.html">read_restart</A> command for information about
|
|
what is stored in a restart file.
|
|
</P>
|
|
<P>Restart files can be read by a <A HREF = "read_restart.html">read_restart</A>
|
|
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 <A HREF = "Section_tools.html#restart">restart2data
|
|
program</A> 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.
|
|
</P>
|
|
<P><B>Restrictions:</B> none
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "write_restart.html">write_restart</A>, <A HREF = "read_restart.html">read_restart</A>
|
|
</P>
|
|
<P><B>Default:</B>
|
|
</P>
|
|
<PRE>restart 0
|
|
</PRE>
|
|
</HTML>
|