forked from lijiext/lammps
188 lines
7.4 KiB
HTML
188 lines
7.4 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>pair_style adp command
|
|
</H3>
|
|
<H3>pair_style adp/omp command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>pair_style adp
|
|
</PRE>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>pair_style adp
|
|
pair_coeff * * Ta.adp Ta
|
|
pair_coeff * * ../potentials/AlCu.adp Al Al Cu
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Style <I>adp</I> computes pairwise interactions for metals and metal alloys
|
|
using the angular dependent potential (ADP) of <A HREF = "#Mishin">(Mishin)</A>,
|
|
which is a generalization of the <A HREF = "pair_eam.html">embedded atom method (EAM)
|
|
potential</A>. The LAMMPS implementation is discussed in
|
|
<A HREF = "#Singh">(Singh)</A>. The total energy Ei of an atom I is given by
|
|
</P>
|
|
<CENTER><IMG SRC = "Eqs/pair_adp.jpg">
|
|
</CENTER>
|
|
<P>where F is the embedding energy which is a function of the atomic
|
|
electron density rho, phi is a pair potential interaction, alpha and
|
|
beta are the element types of atoms I and J, and s and t = 1,2,3 and
|
|
refer to the cartesian coordinates. The mu and lambda terms represent
|
|
the dipole and quadruple distortions of the local atomic environment
|
|
which extend the original EAM framework by introducing angular forces.
|
|
</P>
|
|
<P>Note that unlike for other potentials, cutoffs for ADP potentials are
|
|
not set in the pair_style or pair_coeff command; they are specified in
|
|
the ADP potential files themselves. Likewise, the ADP potential files
|
|
list atomic masses; thus you do not need to use the <A HREF = "mass.html">mass</A>
|
|
command to specify them.
|
|
</P>
|
|
<P>The NIST WWW site distributes and documents ADP potentials:
|
|
</P>
|
|
<PRE>http://www.ctcms.nist.gov/potentials
|
|
</PRE>
|
|
<P>Note that these must be converted into the extended DYNAMO <I>setfl</I>
|
|
format discussed below.
|
|
</P>
|
|
<P>The NIST site is maintained by Chandler Becker (cbecker at nist.gov)
|
|
who is good resource for info on interatomic potentials and file
|
|
formats.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>Only a single pair_coeff command is used with the <I>adp</I> style which
|
|
specifies an extended DYNAMO <I>setfl</I> file, which contains information
|
|
for M elements. These are mapped to LAMMPS atom types by specifying N
|
|
additional arguments after the filename in the pair_coeff command,
|
|
where N is the number of LAMMPS atom types:
|
|
</P>
|
|
<UL><LI>filename
|
|
<LI>N element names = mapping of extended <I>setfl</I> elements to atom types
|
|
</UL>
|
|
<P>As an example, the potentials/AlCu.adp file, included in the
|
|
potentials directory of the LAMMPS distrbution, is an extended <I>setfl</I>
|
|
file which has tabulated ADP values for w elements and their alloy
|
|
interactions: Cu and Al. If your LAMMPS simulation has 4 atoms types
|
|
and you want the 1st 3 to be Al, and the 4th to be Cu, you would use
|
|
the following pair_coeff command:
|
|
</P>
|
|
<PRE>pair_coeff * * AlCu.adp Al Al Al Cu
|
|
</PRE>
|
|
<P>The 1st 2 arguments must be * * so as to span all LAMMPS atom types.
|
|
The first three Al arguments map LAMMPS atom types 1,2,3 to the Al
|
|
element in the extended <I>setfl</I> file. The final Cu argument maps
|
|
LAMMPS atom type 4 to the Al element in the extended <I>setfl</I> file.
|
|
Note that there is no requirement that your simulation use all the
|
|
elements specified by the extended <I>setfl</I> file.
|
|
</P>
|
|
<P>If a mapping value is specified as NULL, the mapping is not performed.
|
|
This can be used when an <I>adp</I> potential is used as part of the
|
|
<I>hybrid</I> pair style. The NULL values are placeholders for atom types
|
|
that will be used with other potentials.
|
|
</P>
|
|
<P><I>Adp</I> files in the <I>potentials</I> directory of the LAMMPS distribution
|
|
have an ".adp" suffix. A DYNAMO <I>setfl</I> file extended for ADP is
|
|
formatted as follows. Basically it is the standard <I>setfl</I> format
|
|
with additional tabulated functions u and w added to the file after
|
|
the tabulated pair potentials. See the <A HREF = "pair_eam.html">pair_eam</A>
|
|
command for further details on the <I>setfl</I> format.
|
|
</P>
|
|
<UL><LI>lines 1,2,3 = comments (ignored)
|
|
<LI>line 4: Nelements Element1 Element2 ... ElementN
|
|
<LI>line 5: Nrho, drho, Nr, dr, cutoff
|
|
</UL>
|
|
<P>Following the 5 header lines are Nelements sections, one for each
|
|
element, each with the following format:
|
|
</P>
|
|
<UL><LI>line 1 = atomic number, mass, lattice constant, lattice type (e.g. FCC)
|
|
<LI>embedding function F(rho) (Nrho values)
|
|
<LI>density function rho(r) (Nr values)
|
|
</UL>
|
|
<P>Following the Nelements sections, Nr values for each pair potential
|
|
phi(r) array are listed for all i,j element pairs in the same format
|
|
as other arrays. Since these interactions are symmetric (i,j = j,i)
|
|
only phi arrays with i >= j are listed, in the following order: i,j =
|
|
(1,1), (2,1), (2,2), (3,1), (3,2), (3,3), (4,1), ..., (Nelements,
|
|
Nelements).
|
|
</P>
|
|
<P>After the phi(r) arrays, each of the u(r) arrays are listed in the
|
|
same order with the same assumptions of symmetry. Directly following
|
|
the u(r), the w(r) arrays are listed.
|
|
</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">this section</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_6">-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">this section</A> of the manual for more
|
|
instructions on how to use the accelerated styles effectively.
|
|
</P>
|
|
<HR>
|
|
|
|
<P><B>Mixing, shift, table, tail correction, restart, rRESPA info</B>:
|
|
</P>
|
|
<P>For atom type pairs I,J and I != J, where types I and J correspond to
|
|
two different element types, no special mixing rules are needed, since
|
|
the ADP potential files specify alloy interactions explicitly.
|
|
</P>
|
|
<P>This pair style does not support the <A HREF = "pair_modify.html">pair_modify</A>
|
|
shift, table, and tail options.
|
|
</P>
|
|
<P>This pair style does not write its information to <A HREF = "restart.html">binary restart
|
|
files</A>, since it is stored in tabulated potential files.
|
|
Thus, you need to re-specify the pair_style and pair_coeff commands in
|
|
an input script that reads a restart file.
|
|
</P>
|
|
<P>This pair style can only be used via the <I>pair</I> keyword of the
|
|
<A HREF = "run_style.html">run_style respa</A> command. It does not support the
|
|
<I>inner</I>, <I>middle</I>, <I>outer</I> keywords.
|
|
</P>
|
|
<HR>
|
|
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>This pair style is part of the MANYBODY package. It is only enabled
|
|
if LAMMPS was built with that package (which it is by default).
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "pair_coeff.html">pair_coeff</A>, <A HREF = "pair_eam.html">pair_eam</A>
|
|
</P>
|
|
<P><B>Default:</B> none
|
|
</P>
|
|
<HR>
|
|
|
|
<A NAME = "Mishin"></A>
|
|
|
|
<P><B>(Mishin)</B> Mishin, Mehl, and Papaconstantopoulos, Acta Mater, 53, 4029
|
|
(2005).
|
|
</P>
|
|
<A NAME = "Singh"></A>
|
|
|
|
<P><B>(Singh)</B> Singh and Warner, Acta Mater, 58, 5797-5805 (2010),
|
|
</P>
|
|
</HTML>
|