forked from lijiext/lammps
145 lines
5.2 KiB
HTML
145 lines
5.2 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>fix qeq/comb command
|
|
</H3>
|
|
<H3>fix qeq/comb/omp command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>fix ID group-ID qeq/comb Nevery precision keyword value ...
|
|
</PRE>
|
|
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
|
|
|
|
<LI>qeq/comb = style name of this fix command
|
|
|
|
<LI>Nevery = perform charge equilibration every this many steps
|
|
|
|
<LI>precision = convergence criterion for charge equilibration
|
|
|
|
<LI>zero or more keyword/value pairs may be appended
|
|
|
|
<LI>keyword = <I>file</I>
|
|
|
|
<PRE> <I>file</I> value = filename
|
|
filename = name of file to write QEQ equilibration info to
|
|
</PRE>
|
|
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>fix 1 surface qeq/comb 10 0.0001
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Perform charge equilibration (QeQ) in conjunction with the COMB
|
|
(Charge-Optimized Many-Body) potential as described in
|
|
<A HREF = "#COMB_1">(COMB_1)</A> and <A HREF = "#COMB_2">(COMB_2)</A>. It performs the charge
|
|
equilibration portion of the calculation using the so-called QEq
|
|
method, whereby the charge on each atom is adjusted to minimize the
|
|
energy of the system. This fix can only be used with the COMB
|
|
potential; see the <A HREF = "fix_qeq_reax.html">fix qeq/reax</A> command for a QeQ
|
|
calculation that can be used with any potential.
|
|
</P>
|
|
<P>Only charges on the atoms in the specified group are equilibrated.
|
|
The fix relies on the pair style (COMB in this case) to calculate the
|
|
per-atom electronegativity (effective force on the charges). An
|
|
electronegativity equalization calculation (or QEq) is performed in an
|
|
interative fashion, which in parallel requires communication at each
|
|
iteration for processors to exchange charge information about nearby
|
|
atoms with each other. See <A HREF = "#Rappe_and_Goddard">Rappe_and_Goddard</A> and
|
|
<A HREF = "#Rick_and_Stuart">Rick_and_Stuart</A> for details.
|
|
</P>
|
|
<P>During a run, charge equilibration is peformed every <I>Nevery</I> time
|
|
steps. Charge equilibration is also always enforced on the first step
|
|
of each run. The <I>precision</I> argument controls the tolerance for the
|
|
difference in electronegativity for all atoms during charge
|
|
equilibration. <I>Precision</I> is a trade-off between the cost of
|
|
performing charge equilibration (more iterations) and accuracy.
|
|
</P>
|
|
<P>If the <I>file</I> keyword is used, then information about each
|
|
equilibration calculation is written to the specifed file.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>omp</I>, or <I>opt</I> suffix are functionally
|
|
the same as the corresponding style without the suffix. They have
|
|
been optimized to run faster, depending on your available hardware, as
|
|
discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A> of the
|
|
manual. The accelerated styles take the same arguments and should
|
|
produce the same results, except for round-off and precision issues.
|
|
</P>
|
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-OMP and OPT
|
|
packages, respectively. They are only enabled if LAMMPS was built with
|
|
those packages. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
|
section for more info.
|
|
</P>
|
|
<P>You can specify the accelerated styles explicitly in your input script
|
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
|
switch</A> when you invoke LAMMPS, or you can
|
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
|
</P>
|
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
|
more instructions on how to use the accelerated styles effectively.
|
|
</P>
|
|
<HR>
|
|
|
|
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
|
|
</P>
|
|
<P>No information about this fix is written to <A HREF = "restart.html">binary restart
|
|
files</A>. None of the <A HREF = "fix_modify.html">fix_modify</A> options
|
|
are relevant to this fix.
|
|
</P>
|
|
<P>This fix produces a per-atom vector which can be accessed by various
|
|
<A HREF = "Section_howto.html#howto_15">output commands</A>. The vector stores the
|
|
gradient of the charge on each atom. The per-atom values be accessed
|
|
on any timestep.
|
|
</P>
|
|
<P>No parameter of this fix can be used with the <I>start/stop</I> keywords of
|
|
the <A HREF = "run.html">run</A> command.
|
|
</P>
|
|
<P>This fix can be invoked during <A HREF = "minimize.html">energy minimization</A>.
|
|
</P>
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>This fix command currently only supports <A HREF = "pair_comb.html">pair style <I>comb</I></A>.
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "pair_comb.html">pair_style comb</A>
|
|
</P>
|
|
<P><B>Default:</B>
|
|
</P>
|
|
<P>No file output is performed.
|
|
</P>
|
|
<HR>
|
|
|
|
<A NAME = "COMB_1"></A>
|
|
|
|
<P><B>(COMB_1)</B> J. Yu, S. B. Sinnott, S. R. Phillpot, Phys Rev B, 75, 085311 (2007),
|
|
</P>
|
|
<A NAME = "COMB_2"></A>
|
|
|
|
<P><B>(COMB_2)</B> T.-R. Shan, B. D. Devine, T. W. Kemper, S. B. Sinnott, S. R.
|
|
Phillpot, Phys Rev B, 81, 125328 (2010).
|
|
</P>
|
|
<A NAME = "Rappe_and_Goddard"></A>
|
|
|
|
<P><B>(Rappe_and_Goddard)</B> A. K. Rappe, W. A. Goddard, J Phys Chem 95, 3358
|
|
(1991).
|
|
</P>
|
|
<A NAME = "Rick_and_Stuart"></A>
|
|
|
|
<P><B>(Rick_and_Stuart)</B> S. W. Rick, S. J. Stuart, B. J. Berne, J Chem Phys
|
|
101, 16141 (1994).
|
|
</P>
|
|
</HTML>
|