forked from lijiext/lammps
328 lines
16 KiB
HTML
328 lines
16 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>tad command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>tad N t_event T_lo T_hi delta tmax compute-ID keyword value ...
|
|
</PRE>
|
|
<UL><LI>N = # of timesteps to run (not including dephasing/quenching)
|
|
|
|
<LI>t_event = timestep interval between event checks
|
|
|
|
<LI>T_lo = temperature at which event times are desired
|
|
|
|
<LI>T_hi = temperature at which MD simulation is performed
|
|
|
|
<LI>delta = desired confidence level for stopping criterion
|
|
|
|
<LI>tmax = reciprocal of lowest expected preexponential factor (time units)
|
|
|
|
<LI>compute-ID = ID of the compute used for event detection
|
|
|
|
<LI>zero or more keyword/value pairs may be appended
|
|
|
|
<LI>keyword = <I>min</I> or <I>neb</I> or <I>min_style</I> or <I>neb_style</I> or <I>neb_log</I>
|
|
|
|
<PRE> <I>min</I> values = etol ftol maxiter maxeval
|
|
etol = stopping tolerance for energy (energy units)
|
|
ftol = stopping tolerance for force (force units)
|
|
maxiter = max iterations of minimize
|
|
maxeval = max number of force/energy evaluations
|
|
<I>neb</I> values = ftol N1 N2 Nevery
|
|
etol = stopping tolerance for energy (energy units)
|
|
ftol = stopping tolerance for force (force units)
|
|
N1 = max # of iterations (timesteps) to run initial NEB
|
|
N2 = max # of iterations (timesteps) to run barrier-climbing NEB
|
|
Nevery = print NEB statistics every this many timesteps
|
|
<I>neb_style</I> value = <I>quickmin</I> or <I>fire</I>
|
|
<I>neb_step</I> value = dtneb
|
|
dtneb = timestep for NEB damped dynamics minimization
|
|
<I>neb_log</I> value = file where NEB statistics are printed
|
|
</PRE>
|
|
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>tad 2000 50 1800 2300 0.01 0.01 event
|
|
tad 2000 50 1800 2300 0.01 0.01 event &
|
|
min 1e-05 1e-05 100 100 &
|
|
neb 0.0 0.01 200 200 20 &
|
|
min_style cg &
|
|
neb_style fire &
|
|
neb_log log.neb
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Run a temperature accelerated dynamics (TAD) simulation. This method
|
|
requires two or more partitions to perform NEB transition state
|
|
searches.
|
|
</P>
|
|
<P>TAD is described in <A HREF = "#Voter">this paper</A> by Art Voter. It is a method
|
|
that uses accelerated dynamics at an elevated temperature to generate
|
|
results at a specified lower temperature. A good overview of
|
|
accelerated dynamics methods for such systems is given in <A HREF = "#Voter2">this review
|
|
paper</A> from the same group. In general, these methods assume
|
|
that the long-time dynamics is dominated by infrequent events i.e. the
|
|
system is is confined to low energy basins for long periods,
|
|
punctuated by brief, randomly-occurring transitions to adjacent
|
|
basins. TAD is suitable for infrequent-event systems, where in
|
|
addition, the transition kinetics are well-approximated by harmonic
|
|
transition state theory (hTST). In hTST, the temperature dependence of
|
|
transition rates follows the Arrhenius relation. As a consequence a
|
|
set of event times generated in a high-temperature simulation can be
|
|
mapped to a set of much longer estimated times in the low-temperature
|
|
system. However, because this mapping involves the energy barrier of
|
|
the transition event, which is different for each event, the first
|
|
event at the high temperature may not be the earliest event at the low
|
|
temperature. TAD handles this by first generating a set of possible
|
|
events from the current basin. After each event, the simulation is
|
|
reflected backwards into the current basin. This is repeated until
|
|
the stopping criterion is satisfied, at which point the event with the
|
|
earliest low-temperature occurrence time is selected. The stopping
|
|
criterion is that the confidence measure be greater than
|
|
1-<I>delta</I>. The confidence measure is the probability that no earlier
|
|
low-temperature event will occur at some later time in the
|
|
high-temperature simulation. hTST provides an lower bound for this
|
|
probability, based on the user-specified minimum pre-exponential
|
|
factor (reciprocal of <I>tmax</I>).
|
|
</P>
|
|
<P>In order to estimate the energy barrier for each event, the TAD method
|
|
invokes the <A HREF = "neb.html">NEB</A> method. Each NEB replica runs on a
|
|
partition of processors. The current NEB implementation in LAMMPS
|
|
restricts you to having exactly one processor per replica. For more
|
|
information, see the documentation for the <A HREF = "neb.html">neb</A> command. In
|
|
the current LAMMPS implementation of TAD, all the non-NEB TAD
|
|
operations are performed on the first partition, while the other
|
|
partitions remain idle. See <A HREF = "Section_howto.html#howto_5">Section_howto
|
|
5</A> of the manual for further discussion of
|
|
multi-replica simulations.
|
|
</P>
|
|
<P>A TAD run has several stages, which are repeated each time an event is
|
|
performed. The logic for a TAD run is as follows:
|
|
</P>
|
|
<PRE>while (time remains):
|
|
while (time < tstop):
|
|
until (event occurs):
|
|
run dynamics for t_event steps
|
|
quench
|
|
run neb calculation using all replicas
|
|
compute tlo from energy barrier
|
|
update earliest event
|
|
update tstop
|
|
reflect back into current basin
|
|
execute earliest event
|
|
</PRE>
|
|
<P>Before this outer loop begins, the initial potential energy basin is
|
|
identified by quenching (an energy minimization, see below) the
|
|
initial state and storing the resulting coordinates for reference.
|
|
</P>
|
|
<P>Inside the inner loop, dynamics is run continuously according to
|
|
whatever integrator has been specified by the user, stopping every
|
|
<I>t_event</I> steps to check if a transition event has occurred. This
|
|
check is performed by quenching the system and comparing the resulting
|
|
atom coordinates to the coordinates from the previous basin.
|
|
</P>
|
|
<P>A quench is an energy minimization and is performed by whichever
|
|
algorithm has been defined by the <A HREF = "min_style.html">min_style</A> command;
|
|
its default is the CG minimizer. The tolerances and limits for each
|
|
quench can be set by the <I>min</I> keyword. Note that typically, you do
|
|
not need to perform a highly-converged minimization to detect a
|
|
transition event.
|
|
</P>
|
|
<P>The event check is performed by a compute with the specified
|
|
<I>compute-ID</I>. Currently there is only one compute that works with the
|
|
TAD commmand, which is the <A HREF = "compute_event_displace.html">compute
|
|
event/displace</A> command. Other
|
|
event-checking computes may be added. <A HREF = "compute_event_displace.html">Compute
|
|
event/displace</A> checks whether any atom in
|
|
the compute group has moved further than a specified threshold
|
|
distance. If so, an "event" has occurred.
|
|
</P>
|
|
<P>The NEB calculation is similar to that invoked by the <A HREF = "neb.html">neb</A>
|
|
command, except that the final state is generated internally, instead
|
|
of being read in from a file. The style of minimization performed by
|
|
NEB is determined by the <I>neb_style</I> keyword and must be a damped
|
|
dynamics minimizer. The tolerances and limits for each NEB
|
|
calculation can be set by the <I>neb</I> keyword. As discussed on the
|
|
<A HREF = "neb.html">neb</A>, it is often advantageous to use a larger timestep for
|
|
NEB than for normal dyanmics. Since the size of the timestep set by
|
|
the <A HREF = "timestep.html">timestep</A> command is used by TAD for performing
|
|
dynamics, there is a <I>neb_step</I> keyword which can be used to set a
|
|
larger timestep for each NEB calculation if desired.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>A key aspect of the TAD method is setting the stopping criterion
|
|
appropriately. If this criterion is too conservative, then many
|
|
events must be generated before one is finally executed. Conversely,
|
|
if this criterion is too aggressive, high-entropy high-barrier events
|
|
will be over-sampled, while low-entropy low-barrier events will be
|
|
under-sampled. If the lowest pre-exponential factor is known fairly
|
|
accurately, then it can be used to estimate <I>tmax</I>, and the value of
|
|
<I>delta</I> can be set to the desired confidence level e.g. <I>delta</I> = 0.05
|
|
corresponds to 95% confidence. However, for systems where the dynamics
|
|
are not well characterized (the most common case), it will be
|
|
necessary to experiment with the values of <I>delta</I> and <I>tmax</I> to get a
|
|
good trade-off between accuracy and performance.
|
|
</P>
|
|
<P>A second key aspect is the choice of <I>t_hi</I>. A larger value greatly
|
|
increases the rate at which new events are generated. However, too
|
|
large a value introduces errors due to anharmonicity (not accounted
|
|
for within hTST). Once again, for any given system, experimentation is
|
|
necessary to determine the best value of <I>t_hi</I>.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>Five kinds of output can be generated during a TAD run: event
|
|
statistics, NEB statistics, thermodynamic output by each replica, dump
|
|
files, and restart files.
|
|
</P>
|
|
<P>Event statistics are printed to the screen and master log.lammps file
|
|
each time an event is executed. The quantities are the timestep, CPU
|
|
time, global event number <I>N</I>, local event number <I>M</I>, event status,
|
|
energy barrier, time margin, <I>t_lo</I> and <I>delt_lo</I>. The timestep is
|
|
the usual LAMMPS timestep, which corresponds to the high-temperature
|
|
time at which the event was detected, in units of timestep. The CPU
|
|
time is the total processor time since the start of the TAD run. The
|
|
global event number <I>N</I> is a counter that increments with each
|
|
executed event. The local event number <I>M</I> is a counter that resets to
|
|
zero upon entering each new basin. The event status is <I>E</I> when an
|
|
event is executed, and is <I>D</I> for an event that is detected, while
|
|
<I>DF</I> is for a detected event that is also the earliest (first) event
|
|
at the low temperature.
|
|
</P>
|
|
<P>The time margin is the ratio of the high temperature time in the
|
|
current basin to the stopping time. This last number can be used to
|
|
judge whether the stopping time is too short or too long (see above).
|
|
</P>
|
|
<P><I>t_lo</I> is the low-temperature event time when the current basin was
|
|
entered, in units of timestep. del<I>t_lo</I> is the time of each detected
|
|
event, measured relative to <I>t_lo</I>. <I>delt_lo</I> is equal to the
|
|
high-temperature time since entering the current basin, scaled by an
|
|
exponential factor that depends on the hi/lo temperature ratio and the
|
|
energy barrier for that event.
|
|
</P>
|
|
<P>On lines for executed events, with status <I>E</I>, the global event number
|
|
is incremented by one,
|
|
the local event number and time margin are reset to zero,
|
|
while the global event number, energy barrier, and
|
|
<I>delt_lo</I> match the last event with status <I>DF</I>
|
|
in the immediately preceding block of detected events.
|
|
The low-temperature event time <I>t_lo</I> is incremented by <I>delt_lo</I>.
|
|
</P>
|
|
<P>NEB statistics are written to the file specified by the <I>neb_log</I>
|
|
keyword. If the keyword value is "none", then no NEB statistics are
|
|
printed out. The statistics are written every <I>Nevery</I> timesteps. See
|
|
the <A HREF = "neb.html">neb</A> command for a full description of the NEB
|
|
statistics. When invoked from TAD, NEB statistics are never printed to
|
|
the screen.
|
|
</P>
|
|
<P>Because the NEB calculation must run on multiple partitions, LAMMPS
|
|
produces additional screen and log files for each partition,
|
|
e.g. log.lammps.0, log.lammps.1, etc. For the TAD command, these
|
|
contain the thermodynamic output of each NEB replica. In addition, the
|
|
log file for the first partition, log.lammps.0, will contain
|
|
thermodynamic output from short runs and minimizations corresponding
|
|
to the dynamics and quench operations, as well as a line for each new
|
|
detected event, as described above.
|
|
</P>
|
|
<P>After the TAD command completes, timing statistics for the TAD run are
|
|
printed in each replica's log file, giving a breakdown of how much CPU
|
|
time was spent in each stage (NEB, dynamics, quenching, etc).
|
|
</P>
|
|
<P>Any <A HREF = "dump.html">dump files</A> defined in the input script will be written
|
|
to during a TAD run at timesteps when an event is executed. This
|
|
means the the requested dump frequency in the <A HREF = "dump.html">dump</A> command
|
|
is ignored. There will be one dump file (per dump command) created
|
|
for all partitions. The atom coordinates of the dump snapshot are
|
|
those of the minimum energy configuration resulting from quenching
|
|
following the executed event. The timesteps written into the dump
|
|
files correspond to the timestep at which the event occurred and NOT
|
|
the clock. A dump snapshot corresponding to the initial minimum state
|
|
used for event detection is written to the dump file at the beginning
|
|
of each TAD run.
|
|
</P>
|
|
<P>If the <A HREF = "restart.html">restart</A> command is used, a single restart file
|
|
for all the partitions is generated, which allows a TAD run to be
|
|
continued by a new input script in the usual manner. The restart file
|
|
is generated after an event is executed. The restart file contains a
|
|
snapshot of the system in the new quenched state, including the event
|
|
number and the low-temperature time. The restart frequency specified
|
|
in the <A HREF = "restart.html">restart</A> command is interpreted differently when
|
|
performing a TAD run. It does not mean the timestep interval between
|
|
restart files. Instead it means an event interval for executed
|
|
events. Thus a frequency of 1 means write a restart file every time
|
|
an event is executed. A frequency of 10 means write a restart file
|
|
every 10th executed event. When an input script reads a restart file
|
|
from a previous TAD run, the new script can be run on a different
|
|
number of replicas or processors.
|
|
</P>
|
|
<P>Note that within a single state, the dynamics will typically
|
|
temporarily continue beyond the event that is ultimately chosen, until
|
|
the stopping criterionis satisfied. When the event is eventually
|
|
executed, the timestep counter is reset to the value when the event
|
|
was detected. Similarly, after each quench and NEB minimization, the
|
|
timestep counter is reset to the value at the start of the
|
|
minimization. This means that the timesteps listed in the replica log
|
|
files do not always increase monotonically. However, the timestep
|
|
values printed to the master log file, dump files, and restart files
|
|
are always monotonically increasing.
|
|
</P>
|
|
<HR>
|
|
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>This command can only be used if LAMMPS was built with the REPLICA
|
|
package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A> section
|
|
for more info on packages.
|
|
</P>
|
|
<P><I>N</I> setting must be integer multiple of <I>t_event</I>.
|
|
</P>
|
|
<P>Runs restarted from restart files written during a TAD run will only
|
|
produce identical results if the user-specified integrator supports
|
|
exact restarts. So <A HREF = "fix_nh.html">fix nvt</A> will produce an exact
|
|
restart, but <A HREF = "fix_langevin.html">fix langevin</A> will not.
|
|
</P>
|
|
<P>This command cannot be used when any fixes are defined that keep track
|
|
of elapsed time to perform time-dependent operations. Examples
|
|
include the "ave" fixes such as <A HREF = "fix_ave_spatial.html">fix
|
|
ave/spatial</A>. Also <A HREF = "fix_dt_reset.html">fix
|
|
dt/reset</A> and <A HREF = "fix_deposit.html">fix deposit</A>.
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "compute_event_displace.html">compute event/displace</A>,
|
|
<A HREF = "min_modify.html">min_modify</A>, <A HREF = "min_style.html">min_style</A>,
|
|
<A HREF = "run_style.html">run_style</A>, <A HREF = "minimize.html">minimize</A>,
|
|
<A HREF = "temper.html">temper</A>, <A HREF = "neb.html">neb</A>,
|
|
<A HREF = "prd.html">prd</A>
|
|
</P>
|
|
<P><B>Default:</B>
|
|
</P>
|
|
<P>The option defaults are <I>min</I> = 0.1 0.1 40 50, <I>neb</I> = 0.01 100 100
|
|
10, <I>neb_style</I> = <I>quickmin</I>, <I>neb_step</I> = the same timestep set by
|
|
the <A HREF = "timestep.html">timestep</A> command, and <I>neb_log</I> = "none".
|
|
</P>
|
|
<HR>
|
|
|
|
<A NAME = "Voter"></A>
|
|
|
|
<P><B>(Voter)</B> Sorensen and Voter, J Chem Phys, 112, 9599 (2000)
|
|
</P>
|
|
<A NAME = "Voter2"></A>
|
|
|
|
<P><B>(Voter2)</B> Voter, Montalenti, Germann, Annual Review of Materials
|
|
Research 32, 321 (2002).
|
|
</P>
|
|
</HTML>
|