2015-07-30 22:53:28 +08:00
<!DOCTYPE html>
<!-- [if IE 8]><html class="no - js lt - ie9" lang="en" > <![endif] -->
<!-- [if gt IE 8]><! --> < html class = "no-js" lang = "en" > <!-- <![endif] -->
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
2015-12-21 23:20:41 +08:00
< title > pair_style eam command — LAMMPS documentation< / title >
2015-07-30 22:53:28 +08:00
< link rel = "stylesheet" href = "_static/css/theme.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/sphinxcontrib-images/LightBox2/lightbox2/css/lightbox.css" type = "text/css" / >
2015-12-21 23:20:41 +08:00
< link rel = "top" title = "LAMMPS documentation" href = "index.html" / >
2015-07-30 22:53:28 +08:00
< script src = "_static/js/modernizr.min.js" > < / script >
< / head >
< body class = "wy-body-for-nav" role = "document" >
< div class = "wy-grid-for-nav" >
< nav data-toggle = "wy-nav-shift" class = "wy-nav-side" >
< div class = "wy-side-nav-search" >
< a href = "Manual.html" class = "icon icon-home" > LAMMPS
< / a >
< div role = "search" >
< form id = "rtd-search-form" class = "wy-form" action = "search.html" method = "get" >
< input type = "text" name = "q" placeholder = "Search docs" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< / div >
< / div >
< div class = "wy-menu wy-menu-vertical" data-spy = "affix" role = "navigation" aria-label = "main navigation" >
< ul >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_intro.html" > 1. Introduction< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_start.html" > 2. Getting Started< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_commands.html" > 3. Commands< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_packages.html" > 4. Packages< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_accelerate.html" > 5. Accelerating LAMMPS performance< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_howto.html" > 6. How-to discussions< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_example.html" > 7. Example problems< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_perf.html" > 8. Performance & scalability< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_tools.html" > 9. Additional tools< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_modify.html" > 10. Modifying & extending LAMMPS< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_python.html" > 11. Python interface to LAMMPS< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_errors.html" > 12. Errors< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "Section_history.html" > 13. Future and history< / a > < / li >
< / ul >
< / div >
< / nav >
< section data-toggle = "wy-nav-shift" class = "wy-nav-content-wrap" >
< nav class = "wy-nav-top" role = "navigation" aria-label = "top navigation" >
< i data-toggle = "wy-nav-top" class = "fa fa-bars" > < / i >
< a href = "Manual.html" > LAMMPS< / a >
< / nav >
< div class = "wy-nav-content" >
< div class = "rst-content" >
< div role = "navigation" aria-label = "breadcrumbs navigation" >
< ul class = "wy-breadcrumbs" >
< li > < a href = "Manual.html" > Docs< / a > » < / li >
< li > pair_style eam command< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "http://lammps.sandia.gov" > Website< / a >
< a href = "Section_commands.html#comm" > Commands< / a >
< / li >
< / ul >
< hr / >
< / div >
< div role = "main" class = "document" itemscope = "itemscope" itemtype = "http://schema.org/Article" >
< div itemprop = "articleBody" >
< div class = "section" id = "pair-style-eam-command" >
< span id = "index-0" > < / span > < h1 > pair_style eam command< a class = "headerlink" href = "#pair-style-eam-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-cuda-command" >
< h1 > pair_style eam/cuda command< a class = "headerlink" href = "#pair-style-eam-cuda-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-gpu-command" >
< h1 > pair_style eam/gpu command< a class = "headerlink" href = "#pair-style-eam-gpu-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-kk-command" >
< h1 > pair_style eam/kk command< a class = "headerlink" href = "#pair-style-eam-kk-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-omp-command" >
< h1 > pair_style eam/omp command< a class = "headerlink" href = "#pair-style-eam-omp-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-opt-command" >
< h1 > pair_style eam/opt command< a class = "headerlink" href = "#pair-style-eam-opt-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-alloy-command" >
< h1 > pair_style eam/alloy command< a class = "headerlink" href = "#pair-style-eam-alloy-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-alloy-cuda-command" >
< h1 > pair_style eam/alloy/cuda command< a class = "headerlink" href = "#pair-style-eam-alloy-cuda-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-alloy-gpu-command" >
< h1 > pair_style eam/alloy/gpu command< a class = "headerlink" href = "#pair-style-eam-alloy-gpu-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-alloy-kk-command" >
< h1 > pair_style eam/alloy/kk command< a class = "headerlink" href = "#pair-style-eam-alloy-kk-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-alloy-omp-command" >
< h1 > pair_style eam/alloy/omp command< a class = "headerlink" href = "#pair-style-eam-alloy-omp-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-alloy-opt-command" >
< h1 > pair_style eam/alloy/opt command< a class = "headerlink" href = "#pair-style-eam-alloy-opt-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-cd-command" >
< h1 > pair_style eam/cd command< a class = "headerlink" href = "#pair-style-eam-cd-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-cd-omp-command" >
< h1 > pair_style eam/cd/omp command< a class = "headerlink" href = "#pair-style-eam-cd-omp-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-fs-command" >
< h1 > pair_style eam/fs command< a class = "headerlink" href = "#pair-style-eam-fs-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-fs-cuda-command" >
< h1 > pair_style eam/fs/cuda command< a class = "headerlink" href = "#pair-style-eam-fs-cuda-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-fs-gpu-command" >
< h1 > pair_style eam/fs/gpu command< a class = "headerlink" href = "#pair-style-eam-fs-gpu-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-fs-kk-command" >
< h1 > pair_style eam/fs/kk command< a class = "headerlink" href = "#pair-style-eam-fs-kk-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-fs-omp-command" >
< h1 > pair_style eam/fs/omp command< a class = "headerlink" href = "#pair-style-eam-fs-omp-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< / div >
< div class = "section" id = "pair-style-eam-fs-opt-command" >
< h1 > pair_style eam/fs/opt command< a class = "headerlink" href = "#pair-style-eam-fs-opt-command" title = "Permalink to this headline" > ¶< / a > < / h1 >
< div class = "section" id = "syntax" >
< h2 > Syntax< a class = "headerlink" href = "#syntax" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_style style
< / pre > < / div >
< / div >
< ul class = "simple" >
< li > style = < em > eam< / em > or < em > eam/alloy< / em > or < em > eam/cd< / em > or < em > eam/fs< / em > < / li >
< / ul >
< / div >
< div class = "section" id = "examples" >
< h2 > Examples< a class = "headerlink" href = "#examples" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_style eam
2006-09-22 00:22:34 +08:00
pair_coeff * * cuu3
2015-07-30 22:53:28 +08:00
pair_coeff 1*3 1*3 niu3.eam
< / pre > < / div >
< / div >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_style eam/alloy
pair_coeff * * ../potentials/NiAlH_jea.eam.alloy Ni Al Ni Ni
< / pre > < / div >
< / div >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_style eam/cd
pair_coeff * * ../potentials/FeCr.cdeam Fe Cr
< / pre > < / div >
< / div >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_style eam/fs
pair_coeff * * NiAlH_jea.eam.fs Ni Al Ni Ni
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "description" >
< h2 > Description< a class = "headerlink" href = "#description" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Style < em > eam< / em > computes pairwise interactions for metals and metal alloys
using embedded-atom method (EAM) potentials < a class = "reference internal" href = "pair_polymorphic.html#daw" > < span > (Daw)< / span > < / a > . The total
energy Ei of an atom I is given by< / p >
< img alt = "_images/pair_eam.jpg" class = "align-center" src = "_images/pair_eam.jpg" / >
< p > where F is the embedding energy which is a function of the atomic
2006-09-22 00:22:34 +08:00
electron density rho, phi is a pair potential interaction, and alpha
and beta are the element types of atoms I and J. The multi-body
nature of the EAM potential is a result of the embedding energy term.
Both summations in the formula are over all neighbors J of atom I
2015-07-30 22:53:28 +08:00
within the cutoff distance.< / p >
< p > The cutoff distance and the tabulated values of the functionals F,
2006-09-22 00:22:34 +08:00
rho, and phi are listed in one or more files which are specified by
2015-07-30 22:53:28 +08:00
the < a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a > command. These are ASCII text files
2008-11-17 22:56:58 +08:00
in a DYNAMO-style format which is described below. DYNAMO was the
original serial EAM MD code, written by the EAM originators. Several
DYNAMO potential files for different metals are included in the
2015-07-30 22:53:28 +08:00
“ potentials” directory of the LAMMPS distribution. All of these files
are parameterized in terms of LAMMPS < a class = "reference internal" href = "units.html" > < em > metal units< / em > < / a > .< / p >
2015-12-11 01:23:56 +08:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
< p class = "last" > The < em > eam< / em > style reads single-element EAM potentials in the
DYNAMO < em > funcfl< / em > format. Either single element or alloy systems can be
modeled using multiple < em > funcfl< / em > files and style < em > eam< / em > . For the alloy
case LAMMPS mixes the single-element potentials to produce alloy
2006-11-02 07:01:32 +08:00
potentials, the same way that DYNAMO does. Alternatively, a single
2015-07-30 22:53:28 +08:00
DYNAMO < em > setfl< / em > file or Finnis/Sinclair EAM file can be used by LAMMPS
to model alloy systems by invoking the < em > eam/alloy< / em > or < em > eam/cd< / em > or
< em > eam/fs< / em > styles as described below. These files require no mixing
since they specify alloy interactions explicitly.< / p >
< / div >
2015-12-11 01:23:56 +08:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
2015-07-30 22:53:28 +08:00
< p class = "last" > Note that unlike for other potentials, cutoffs for EAM
2015-07-08 23:12:22 +08:00
potentials are not set in the pair_style or pair_coeff command; they
are specified in the EAM potential files themselves. Likewise, the
EAM potential files list atomic masses; thus you do not need to use
2015-07-30 22:53:28 +08:00
the < a class = "reference internal" href = "mass.html" > < em > mass< / em > < / a > command to specify them.< / p >
< / div >
< p > There are several WWW sites that distribute and document EAM
potentials stored in DYNAMO or other formats:< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > http://www.ctcms.nist.gov/potentials
2008-11-14 01:11:56 +08:00
http://cst-www.nrl.navy.mil/ccm6/ap
2015-07-30 22:53:28 +08:00
http://enpub.fulton.asu.edu/cms/potentials/main/main.htm
< / pre > < / div >
< / div >
< p > These potentials should be usable with LAMMPS, though the alternate
2008-11-14 01:11:56 +08:00
formats would need to be converted to the DYNAMO format used by LAMMPS
2009-01-14 22:29:55 +08:00
and described on this page. The NIST site is maintained by Chandler
Becker (cbecker at nist.gov) who is good resource for info on
2015-07-30 22:53:28 +08:00
interatomic potentials and file formats.< / p >
< hr class = "docutils" / >
< p > For style < em > eam< / em > , potential values are read from a file that is in the
DYNAMO single-element < em > funcfl< / em > format. If the DYNAMO file was created
by a Fortran program, it cannot have “ D” values in it for exponents.
C only recognizes “ e” or “ E” for scientific notation.< / p >
< p > Note that unlike for other potentials, cutoffs for EAM potentials are
2006-11-02 07:01:32 +08:00
not set in the pair_style or pair_coeff command; they are specified in
2015-07-30 22:53:28 +08:00
the EAM potential files themselves.< / p >
< p > For style < em > eam< / em > a potential file must be assigned to each I,I pair of
2006-11-02 07:01:32 +08:00
atom types by using one or more pair_coeff commands, each with a
2015-07-30 22:53:28 +08:00
single argument:< / p >
< ul class = "simple" >
< li > filename< / li >
< / ul >
< p > Thus the following command< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_coeff *2 1*2 cuu3.eam
< / pre > < / div >
< / div >
< p > will read the cuu3 potential file and use the tabulated Cu values for
2006-09-22 00:22:34 +08:00
F, phi, rho that it contains for type pairs 1,1 and 2,2 (type pairs
2015-07-30 22:53:28 +08:00
1,2 and 2,1 are ignored). See the < a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a > doc
2013-06-29 01:19:51 +08:00
page for alternate ways to specify the path for the potential file.
In effect, this makes atom types 1 and 2 in LAMMPS be Cu atoms.
Different single-element files can be assigned to different atom types
to model an alloy system. The mixing to create alloy potentials for
type pairs with I != J is done automatically the same way that the
serial DYNAMO code originally did it; you do not need to specify
2015-07-30 22:53:28 +08:00
coefficients for these type pairs.< / p >
< p > < em > Funcfl< / em > files in the < em > potentials< / em > directory of the LAMMPS
distribution have an ” .eam” suffix. A DYNAMO single-element < em > funcfl< / em >
file is formatted as follows:< / p >
< ul class = "simple" >
< li > line 1: comment (ignored)< / li >
< li > line 2: atomic number, mass, lattice constant, lattice type (e.g. FCC)< / li >
< li > line 3: Nrho, drho, Nr, dr, cutoff< / li >
< / ul >
< p > On line 2, all values but the mass are ignored by LAMMPS. The mass is
in mass < a class = "reference internal" href = "units.html" > < em > units< / em > < / a > , e.g. mass number or grams/mole for metal
2010-12-07 23:26:24 +08:00
units. The cubic lattice constant is in Angstroms. On line 3, Nrho
2007-06-20 20:56:17 +08:00
and Nr are the number of tabulated values in the subsequent arrays,
drho and dr are the spacing in density and distance space for the
values in those arrays, and the specified cutoff becomes the pairwise
cutoff used by LAMMPS for the potential. The units of dr are
2015-07-30 22:53:28 +08:00
Angstroms; I’ m not sure of the units for drho - some measure of
electron density.< / p >
< p > Following the three header lines are three arrays of tabulated values:< / p >
< ul class = "simple" >
< li > embedding function F(rho) (Nrho values)< / li >
< li > effective charge function Z(r) (Nr values)< / li >
< li > density function rho(r) (Nr values)< / li >
< / ul >
< p > The values for each array can be listed as multiple values per line,
2006-11-02 07:01:32 +08:00
so long as each array starts on a new line. For example, the
2015-07-30 22:53:28 +08:00
individual Z(r) values are for r = 0,dr,2*dr, ... (Nr-1)*dr.< / p >
< p > The units for the embedding function F are eV. The units for the
2006-11-02 07:01:32 +08:00
density function rho are the same as for drho (see above, electron
2015-07-30 22:53:28 +08:00
density). The units for the effective charge Z are “ atomic charge” or
2008-03-01 09:13:20 +08:00
sqrt(Hartree * Bohr-radii). For two interacting atoms i,j this is used
2006-11-02 07:01:32 +08:00
by LAMMPS to compute the pair potential term in the EAM energy
2015-07-30 22:53:28 +08:00
expression as r*phi, in units of eV-Angstroms, via the formula< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > < span class = "n" > r< / span > < span class = "o" > *< / span > < span class = "n" > phi< / span > < span class = "o" > =< / span > < span class = "mf" > 27.2< / span > < span class = "o" > *< / span > < span class = "mf" > 0.529< / span > < span class = "o" > *< / span > < span class = "n" > Zi< / span > < span class = "o" > *< / span > < span class = "n" > Zj< / span >
< / pre > < / div >
< / div >
< p > where 1 Hartree = 27.2 eV and 1 Bohr = 0.529 Angstroms.< / p >
< hr class = "docutils" / >
< p > Style < em > eam/alloy< / em > computes pairwise interactions using the same
formula as style < em > eam< / em > . However the associated
< a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a > command reads a DYNAMO < em > setfl< / em > file
instead of a < em > funcfl< / em > file. < em > Setfl< / em > files can be used to model a
2006-09-22 00:22:34 +08:00
single-element or alloy system. In the alloy case, as explained
2015-07-30 22:53:28 +08:00
above, < em > setfl< / em > files contain explicit tabulated values for alloy
interactions. Thus they allow more generality than < em > funcfl< / em > files for
modeling alloys.< / p >
< p > For style < em > eam/alloy< / em > , potential values are read from a file that is
in the DYNAMO multi-element < em > setfl< / em > format, except that element names
2006-11-02 07:01:32 +08:00
(Ni, Cu, etc) are added to one of the lines in the file. If the
2015-07-30 22:53:28 +08:00
DYNAMO file was created by a Fortran program, it cannot have “ D”
values in it for exponents. C only recognizes “ e” or “ E” for
scientific notation.< / p >
< p > Only a single pair_coeff command is used with the < em > eam/alloy< / em > style
which specifies a DYNAMO < em > setfl< / em > file, which contains information for
2006-11-04 01:09:44 +08:00
M elements. These are mapped to LAMMPS atom types by specifying N
additional arguments after the filename in the pair_coeff command,
2015-07-30 22:53:28 +08:00
where N is the number of LAMMPS atom types:< / p >
< ul class = "simple" >
< li > filename< / li >
< li > N element names = mapping of < em > setfl< / em > elements to atom types< / li >
< / ul >
< p > As an example, the potentials/NiAlH_jea.eam.alloy file is a < em > setfl< / em >
2011-06-09 04:56:17 +08:00
file which has tabulated EAM values for 3 elements and their alloy
2015-07-30 22:53:28 +08:00
interactions: Ni, Al, and H. See the < a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a > doc
2013-06-29 01:19:51 +08:00
page for alternate ways to specify the path for the potential file.
If your LAMMPS simulation has 4 atoms types and you want the 1st 3 to
be Ni, and the 4th to be Al, you would use the following pair_coeff
2015-07-30 22:53:28 +08:00
command:< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_coeff * * NiAlH_jea.eam.alloy Ni Ni Ni Al
< / pre > < / div >
< / div >
< p > The 1st 2 arguments must be * * so as to span all LAMMPS atom types.
2006-11-02 07:01:32 +08:00
The first three Ni arguments map LAMMPS atom types 1,2,3 to the Ni
2015-07-30 22:53:28 +08:00
element in the < em > setfl< / em > file. The final Al argument maps LAMMPS atom
type 4 to the Al element in the < em > setfl< / em > file. Note that there is no
2006-11-04 01:09:44 +08:00
requirement that your simulation use all the elements specified by the
2015-07-30 22:53:28 +08:00
< em > setfl< / em > file.< / p >
< p > If a mapping value is specified as NULL, the mapping is not performed.
This can be used when an < em > eam/alloy< / em > potential is used as part of the
< em > hybrid< / em > pair style. The NULL values are placeholders for atom types
that will be used with other potentials.< / p >
< p > < em > Setfl< / em > files in the < em > potentials< / em > directory of the LAMMPS distribution
have an ” .eam.alloy” suffix. A DYNAMO multi-element < em > setfl< / em > file is
formatted as follows:< / p >
< ul class = "simple" >
< li > lines 1,2,3 = comments (ignored)< / li >
< li > line 4: Nelements Element1 Element2 ... ElementN< / li >
< li > line 5: Nrho, drho, Nr, dr, cutoff< / li >
< / ul >
< p > In a DYNAMO < em > setfl< / em > file, line 4 only lists Nelements = the # of
elements in the < em > setfl< / em > file. For LAMMPS, the element name (Ni, Cu,
2006-11-02 07:01:32 +08:00
etc) of each element must be added to the line, in the order the
2015-07-30 22:53:28 +08:00
elements appear in the file.< / p >
< p > The meaning and units of the values in line 5 is the same as for the
< em > funcfl< / em > file described above. Note that the cutoff (in Angstroms) is
2006-11-02 07:01:32 +08:00
a global value, valid for all pairwise interactions for all element
2015-07-30 22:53:28 +08:00
pairings.< / p >
< p > Following the 5 header lines are Nelements sections, one for each
element, each with the following format:< / p >
< ul class = "simple" >
< li > line 1 = atomic number, mass, lattice constant, lattice type (e.g. FCC)< / li >
< li > embedding function F(rho) (Nrho values)< / li >
< li > density function rho(r) (Nr values)< / li >
< / ul >
< p > As with the < em > funcfl< / em > files, only the mass (in mass < a class = "reference internal" href = "units.html" > < em > units< / em > < / a > ,
2010-12-07 23:26:24 +08:00
e.g. mass number or grams/mole for metal units) is used by LAMMPS from
the 1st line. The cubic lattice constant is in Angstroms. The F and
rho arrays are unique to a single element and have the same format and
2015-07-30 22:53:28 +08:00
units as in a < em > funcfl< / em > file.< / p >
< p > Following the Nelements sections, Nr values for each pair potential
2006-11-02 07:01:32 +08:00
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)
2015-07-30 22:53:28 +08:00
only phi arrays with i > = j are listed, in the following order: i,j =
2006-09-22 00:22:34 +08:00
(1,1), (2,1), (2,2), (3,1), (3,2), (3,3), (4,1), ..., (Nelements,
2015-07-30 22:53:28 +08:00
Nelements). Unlike the effective charge array Z(r) in < em > funcfl< / em > files,
the tabulated values for each phi function are listed in < em > setfl< / em > files
2006-11-02 07:01:32 +08:00
directly as r*phi (in units of eV-Angstroms), since they are for atom
2015-07-30 22:53:28 +08:00
pairs.< / p >
< hr class = "docutils" / >
< p > Style < em > eam/cd< / em > is similar to the < em > eam/alloy< / em > style, except that it
2009-11-06 03:59:04 +08:00
computes alloy pairwise interactions using the concentration-dependent
embedded-atom method (CD-EAM). This model can reproduce the enthalpy
of mixing of alloys over the full composition range, as described in
2015-07-30 22:53:28 +08:00
< a class = "reference internal" href = "#stukowski" > < span > (Stukowski)< / span > < / a > .< / p >
< p > The pair_coeff command is specified the same as for the < em > eam/alloy< / em >
style. However the DYNAMO < em > setfl< / em > file must has two
lines added to it, at the end of the file:< / p >
< ul class = "simple" >
< li > line 1: Comment line (ignored)< / li >
< li > line 2: N Coefficient0 Coefficient1 ... CoeffincientN< / li >
< / ul >
< p > The last line begins with the degree < em > N< / em > of the polynomial function
< em > h(x)< / em > that modifies the cross interaction between A and B elements.
Then < em > N+1< / em > coefficients for the terms of the polynomial are then
listed.< / p >
< p > Modified EAM < em > setfl< / em > files used with the < em > eam/cd< / em > style must contain
exactly two elements, i.e. in the current implementation the < em > eam/cd< / em >
2009-11-06 03:59:04 +08:00
style only supports binary alloys. The first and second elements in
2015-07-30 22:53:28 +08:00
the input EAM file are always taken as the < em > A< / em > and < em > B< / em > species.< / p >
< p > < em > CD-EAM< / em > files in the < em > potentials< / em > directory of the LAMMPS
distribution have a ” .cdeam” suffix.< / p >
< hr class = "docutils" / >
< p > Style < em > eam/fs< / em > computes pairwise interactions for metals and metal
2006-09-22 00:22:34 +08:00
alloys using a generalized form of EAM potentials due to Finnis and
2015-07-30 22:53:28 +08:00
Sinclair < a class = "reference internal" href = "#finnis" > < span > (Finnis)< / span > < / a > . The total energy Ei of an atom I is
given by< / p >
< img alt = "_images/pair_eam_fs.jpg" class = "align-center" src = "_images/pair_eam_fs.jpg" / >
< p > This has the same form as the EAM formula above, except that rho is
2006-09-22 00:22:34 +08:00
now a functional specific to the atomic types of both atoms I and J,
so that different elements can contribute differently to the total
electron density at an atomic site depending on the identity of the
2015-07-30 22:53:28 +08:00
element at that atomic site.< / p >
< p > The associated < a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a > command for style < em > eam/fs< / em >
reads a DYNAMO < em > setfl< / em > file that has been extended to include
2006-11-04 04:18:04 +08:00
additional rho_alpha_beta arrays of tabulated values. A discussion of
how FS EAM differs from conventional EAM alloy potentials is given in
2015-07-30 22:53:28 +08:00
< a class = "reference internal" href = "#ackland1" > < span > (Ackland1)< / span > < / a > . An example of such a potential is the same
author’ s Fe-P FS potential < a class = "reference internal" href = "#ackland2" > < span > (Ackland2)< / span > < / a > . Note that while FS
2006-11-04 04:18:04 +08:00
potentials always specify the embedding energy with a square root
dependence on the total density, the implementation in LAMMPS does not
require that; the user can tabulate any functional form desired in the
2015-07-30 22:53:28 +08:00
FS potential files.< / p >
< p > For style < em > eam/fs< / em > , the form of the pair_coeff command is exactly the
same as for style < em > eam/alloy< / em > , e.g.< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > pair_coeff * * NiAlH_jea.eam.fs Ni Ni Ni Al
< / pre > < / div >
< / div >
< p > where there are N additional arguments after the filename, where N is
the number of LAMMPS atom types. See the < a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a >
2013-06-29 01:19:51 +08:00
doc page for alternate ways to specify the path for the potential
file. The N values determine the mapping of LAMMPS atom types to EAM
2015-07-30 22:53:28 +08:00
elements in the file, as described above for style < em > eam/alloy< / em > . As
with < em > eam/alloy< / em > , if a mapping value is NULL, the mapping is not
performed. This can be used when an < em > eam/fs< / em > potential is used as
part of the < em > hybrid< / em > pair style. The NULL values are used as
placeholders for atom types that will be used with other potentials.< / p >
< p > FS EAM files include more information than the DYNAMO < em > setfl< / em > format
files read by < em > eam/alloy< / em > , in that i,j density functionals for all
2006-09-28 03:12:31 +08:00
pairs of elements are included as needed by the Finnis/Sinclair
2015-07-30 22:53:28 +08:00
formulation of the EAM.< / p >
< p > FS EAM files in the < em > potentials< / em > directory of the LAMMPS distribution
have an ” .eam.fs” suffix. They are formatted as follows:< / p >
< ul class = "simple" >
< li > lines 1,2,3 = comments (ignored)< / li >
< li > line 4: Nelements Element1 Element2 ... ElementN< / li >
< li > line 5: Nrho, drho, Nr, dr, cutoff< / li >
< / ul >
< p > The 5-line header section is identical to an EAM < em > setfl< / em > file.< / p >
< p > Following the header are Nelements sections, one for each element I,
each with the following format:< / p >
< ul class = "simple" >
< li > line 1 = atomic number, mass, lattice constant, lattice type (e.g. FCC)< / li >
< li > embedding function F(rho) (Nrho values)< / li >
< li > density function rho(r) for element I at element 1 (Nr values)< / li >
< li > density function rho(r) for element I at element 2< / li >
< li > ...< / li >
< li > density function rho(r) for element I at element Nelement< / li >
< / ul >
< p > The units of these quantities in line 1 are the same as for < em > setfl< / em >
2006-11-02 07:01:32 +08:00
files. Note that the rho(r) arrays in Finnis/Sinclair can be
asymmetric (i,j != j,i) so there are Nelements^2 of them listed in the
2015-07-30 22:53:28 +08:00
file.< / p >
< p > Following the Nelements sections, Nr values for each pair potential
2006-11-02 07:01:32 +08:00
phi(r) array are listed in the same manner (r*phi, units of
2015-07-30 22:53:28 +08:00
eV-Angstroms) as in EAM < em > setfl< / em > files. Note that in Finnis/Sinclair,
the phi(r) arrays are still symmetric, so only phi arrays for i > = j
are listed.< / p >
< hr class = "docutils" / >
< p > Styles with a < em > cuda< / em > , < em > gpu< / em > , < em > intel< / em > , < em > kk< / em > , < em > omp< / em > , or < em > opt< / em > suffix are
2014-08-15 00:30:25 +08:00
functionally the same as the corresponding style without the suffix.
They have been optimized to run faster, depending on your available
2015-07-30 22:53:28 +08:00
hardware, as discussed in < a class = "reference internal" href = "Section_accelerate.html" > < em > Section_accelerate< / em > < / a >
2014-08-15 00:30:25 +08:00
of the manual. The accelerated styles take the same arguments and
should produce the same results, except for round-off and precision
2015-07-30 22:53:28 +08:00
issues.< / p >
< p > These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
2014-08-15 00:30:25 +08:00
KOKKOS, USER-OMP and OPT packages, respectively. They are only
2015-07-30 22:53:28 +08:00
enabled if LAMMPS was built with those packages. See the < a class = "reference internal" href = "Section_start.html#start-3" > < span > Making LAMMPS< / span > < / 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 class = "reference internal" href = "Section_start.html#start-7" > < span > -suffix command-line switch< / span > < / a > when you invoke LAMMPS, or you can
use the < a class = "reference internal" href = "suffix.html" > < em > suffix< / em > < / a > command in your input script.< / p >
< p > See < a class = "reference internal" href = "Section_accelerate.html" > < em > Section_accerlate< / em > < / a > of the manual for more
instructions on how to use the accelerated styles effectively.< / p >
< hr class = "docutils" / >
< p > < strong > Mixing, shift, table, tail correction, restart, rRESPA info< / strong > :< / p >
< p > For atom type pairs I,J and I != J, where types I and J correspond to
2007-06-26 08:03:39 +08:00
two different element types, mixing is performed by LAMMPS as
2007-06-25 22:36:36 +08:00
described above with the individual styles. You never need to specify
2015-07-30 22:53:28 +08:00
a pair_coeff command with I != J arguments for the eam styles.< / p >
< p > This pair style does not support the < a class = "reference internal" href = "pair_modify.html" > < em > pair_modify< / em > < / a >
shift, table, and tail options.< / p >
< p > The eam pair styles do not write their information to < a class = "reference internal" href = "restart.html" > < em > binary restart files< / em > < / a > , since it is stored in tabulated potential files.
2008-10-09 22:47:45 +08:00
Thus, you need to re-specify the pair_style and pair_coeff commands in
2015-07-30 22:53:28 +08:00
an input script that reads a restart file.< / p >
< p > The eam pair styles can only be used via the < em > pair< / em > keyword of the
< a class = "reference internal" href = "run_style.html" > < em > run_style respa< / em > < / a > command. They do not support the
< em > inner< / em > , < em > middle< / em > , < em > outer< / em > keywords.< / p >
< / div >
< hr class = "docutils" / >
< div class = "section" id = "restrictions" >
< h2 > Restrictions< a class = "headerlink" href = "#restrictions" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > All of these styles except the < em > eam/cd< / em > style are part of the MANYBODY
2011-08-27 02:53:00 +08:00
package. They are only enabled if LAMMPS was built with that package
2015-07-30 22:53:28 +08:00
(which it is by default). See the < a class = "reference internal" href = "Section_start.html#start-3" > < span > Making LAMMPS< / span > < / a > section for more info.< / p >
< p > The < em > eam/cd< / em > style is part of the USER-MISC package and also requires
2011-08-27 02:53:00 +08:00
the MANYBODY package. It is only enabled if LAMMPS was built with
2015-07-30 22:53:28 +08:00
those packages. See the < a class = "reference internal" href = "Section_start.html#start-3" > < span > Making LAMMPS< / span > < / a >
section for more info.< / p >
< / div >
< div class = "section" id = "related-commands" >
< h2 > Related commands< a class = "headerlink" href = "#related-commands" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > < a class = "reference internal" href = "pair_coeff.html" > < em > pair_coeff< / em > < / a > < / p >
< p > < strong > Default:< / strong > none< / p >
< hr class = "docutils" / >
< p id = "ackland1" > < strong > (Ackland1)< / strong > Ackland, Condensed Matter (2005).< / p >
< p id = "ackland2" > < strong > (Ackland2)< / strong > Ackland, Mendelev, Srolovitz, Han and Barashev, Journal
of Physics: Condensed Matter, 16, S2629 (2004).< / p >
< p id = "daw" > < strong > (Daw)< / strong > Daw, Baskes, Phys Rev Lett, 50, 1285 (1983).
Daw, Baskes, Phys Rev B, 29, 6443 (1984).< / p >
< p id = "finnis" > < strong > (Finnis)< / strong > Finnis, Sinclair, Philosophical Magazine A, 50, 45 (1984).< / p >
< p id = "stukowski" > < strong > (Stukowski)< / strong > Stukowski, Sadigh, Erhart, Caro; Modeling Simulation
Materials Science & Engineering, 7, 075005 (2009).< / p >
< / div >
< / div >
< / div >
< / div >
< footer >
< hr / >
< div role = "contentinfo" >
< p >
2015-12-11 01:23:56 +08:00
© Copyright 2013 Sandia Corporation.
2015-07-30 22:53:28 +08:00
< / p >
< / div >
Built with < a href = "http://sphinx-doc.org/" > Sphinx< / a > using a < a href = "https://github.com/snide/sphinx_rtd_theme" > theme< / a > provided by < a href = "https://readthedocs.org" > Read the Docs< / a > .
< / footer >
< / div >
< / div >
< / section >
< / div >
< script type = "text/javascript" >
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
2015-12-21 23:20:41 +08:00
VERSION:'',
2015-07-30 22:53:28 +08:00
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
< / script >
< script type = "text/javascript" src = "_static/jquery.js" > < / script >
< script type = "text/javascript" src = "_static/underscore.js" > < / script >
< script type = "text/javascript" src = "_static/doctools.js" > < / script >
< script type = "text/javascript" src = "https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML" > < / script >
< script type = "text/javascript" src = "_static/sphinxcontrib-images/LightBox2/lightbox2/js/jquery-1.11.0.min.js" > < / script >
< script type = "text/javascript" src = "_static/sphinxcontrib-images/LightBox2/lightbox2/js/lightbox.min.js" > < / script >
< script type = "text/javascript" src = "_static/sphinxcontrib-images/LightBox2/lightbox2-customize/jquery-noconflict.js" > < / script >
< script type = "text/javascript" src = "_static/js/theme.js" > < / script >
< script type = "text/javascript" >
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
< / script >
< / body >
< / html >
