From f0583512dcc2a256dd9daafe88b297e40f37698e Mon Sep 17 00:00:00 2001 From: sjplimp Date: Wed, 1 Sep 2010 00:31:09 +0000 Subject: [PATCH] git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@4635 f3b2605a-c512-4ea7-a41b-209d697bcdaa --- doc/Eqs/pair_eim1.jpg | Bin 0 -> 3881 bytes doc/Eqs/pair_eim1.tex | 9 +++ doc/Eqs/pair_eim2.jpg | Bin 0 -> 5003 bytes doc/Eqs/pair_eim2.tex | 11 +++ doc/Eqs/pair_eim3.jpg | Bin 0 -> 22990 bytes doc/Eqs/pair_eim3.tex | 25 ++++++ doc/Eqs/pair_tersoff_1.tex | 2 +- doc/Section_commands.html | 22 +++--- doc/Section_commands.txt | 1 + doc/Section_intro.html | 2 +- doc/Section_intro.txt | 2 +- doc/pair_coeff.html | 1 + doc/pair_coeff.txt | 1 + doc/pair_eim.html | 153 +++++++++++++++++++++++++++++++++++++ doc/pair_eim.txt | 147 +++++++++++++++++++++++++++++++++++ doc/pair_style.html | 1 + doc/pair_style.txt | 1 + 17 files changed, 364 insertions(+), 14 deletions(-) create mode 100644 doc/Eqs/pair_eim1.jpg create mode 100644 doc/Eqs/pair_eim1.tex create mode 100644 doc/Eqs/pair_eim2.jpg create mode 100644 doc/Eqs/pair_eim2.tex create mode 100644 doc/Eqs/pair_eim3.jpg create mode 100644 doc/Eqs/pair_eim3.tex create mode 100644 doc/pair_eim.html create mode 100644 doc/pair_eim.txt diff --git a/doc/Eqs/pair_eim1.jpg b/doc/Eqs/pair_eim1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9e4a560b1c554e833b9497b02ef87cb592f26ce5 GIT binary patch literal 3881 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 literal 0 HcmV?d00001 diff --git a/doc/Eqs/pair_eim3.tex b/doc/Eqs/pair_eim3.tex new file mode 100644 index 0000000000..84343c6acf --- /dev/null +++ b/doc/Eqs/pair_eim3.tex @@ -0,0 +1,25 @@ +\documentstyle[12pt]{article} + +\begin{document} + +\begin{eqnarray*} +\phi_{ij}\left(r\right) = \left\{ \begin{array}{lr} +\left[\frac{E_{b,ij}\beta_{ij}}{\beta_{ij}-\alpha_{ij}}\exp\left(-\alpha_{ij} \frac{r-r_{e,ij}}{r_{e,ij}}\right)-\frac{E_{b,ij}\alpha_{ij}}{\beta_{ij}-\alpha_{ij}}\exp\left(-\beta_{ij} \frac{r-r_{e,ij}}{r_{e,ij}}\right)\right]f_c\left(r,r_{e,ij},r_{c,\phi,ij}\right),& p_{ij}=1 \\ +\left[\frac{E_{b,ij}\beta_{ij}}{\beta_{ij}-\alpha_{ij}} \left(\frac{r_{e,ij}}{r}\right)^{\alpha_{ij}} -\frac{E_{b,ij}\alpha_{ij}}{\beta_{ij}-\alpha_{ij}} \left(\frac{r_{e,ij}}{r}\right)^{\beta_{ij}}\right]f_c\left(r,r_{e,ij},r_{c,\phi,ij}\right),& p_{ij}=2 +\end{array} +\right. +\end{eqnarray*} + +$$ +\eta_{ji} = A_{\eta,ij}\left(\chi_j-\chi_i\right)f_c\left(r,r_{s,\eta,ij},r_{c,\eta,ij}\right) +$$ + +$$ +\psi_{ij}\left(r\right) = A_{\psi,ij}\exp\left(-\zeta_{ij}r\right)f_c\left(r,r_{s,\psi,ij},r_{c,\psi,ij}\right) +$$ + +$$ +f_{c}\left(r,r_p,r_c\right) = 0.510204 erfc\left[\frac{1.64498\left(2r-r_p-r_c\right)}{r_c-r_p}\right] - 0.010204 +$$ + +\end{document} diff --git a/doc/Eqs/pair_tersoff_1.tex b/doc/Eqs/pair_tersoff_1.tex index dd0dce0c6d..7d34712491 100644 --- a/doc/Eqs/pair_tersoff_1.tex +++ b/doc/Eqs/pair_tersoff_1.tex @@ -19,6 +19,6 @@ g(\theta) & = & \gamma_{ijk} \left( 1 + \frac{c^2}{d^2} - \frac{c^2}{\left[ d^2 + (\cos \theta - \cos \theta_0)^2\right]} \right) -\end{eqnarray*} +\end{eqnarray*} \end{document} diff --git a/doc/Section_commands.html b/doc/Section_commands.html index afebefe7a4..3a95a5f681 100644 --- a/doc/Section_commands.html +++ b/doc/Section_commands.html @@ -379,17 +379,17 @@ potentials. Click on the style itself for a full description: colloidcombcoul/cutcoul/debye coul/longdipole/cutdpddpd/tstat dsmceameam/opteam/alloy -eam/alloy/opteam/fseam/fs/optgayberne -gayberne/gpugran/hertz/historygran/hookegran/hooke/history -lj/charmm/coul/charmmlj/charmm/coul/charmm/implicitlj/charmm/coul/longlj/charmm/coul/long/opt -lj/class2lj/class2/coul/cutlj/class2/coul/longlj/cut -lj/cut/gpulj/cut/optlj/cut/coul/cutlj/cut/coul/debye -lj/cut/coul/longlj/cut/coul/long/tip4plj/expandlj/gromacs -lj/gromacs/coul/gromacslj/smoothlj96/cutlubricate -meammorsemorse/optperi/lps -peri/pmbreaxresquaredsoft -swtabletersofftersoff/zbl -yukawayukawa/colloid +eam/alloy/opteam/fseam/fs/opteim +gaybernegayberne/gpugran/hertz/historygran/hooke +gran/hooke/historylj/charmm/coul/charmmlj/charmm/coul/charmm/implicitlj/charmm/coul/long +lj/charmm/coul/long/optlj/class2lj/class2/coul/cutlj/class2/coul/long +lj/cutlj/cut/gpulj/cut/optlj/cut/coul/cut +lj/cut/coul/debyelj/cut/coul/longlj/cut/coul/long/tip4plj/expand +lj/gromacslj/gromacs/coul/gromacslj/smoothlj96/cut +lubricatemeammorsemorse/opt +peri/lpsperi/pmbreaxresquared +softswtabletersoff +tersoff/zblyukawayukawa/colloid

These are pair styles contributed by users, which can be used if diff --git a/doc/Section_commands.txt b/doc/Section_commands.txt index c48f25cecd..a527a4768d 100644 --- a/doc/Section_commands.txt +++ b/doc/Section_commands.txt @@ -551,6 +551,7 @@ potentials. Click on the style itself for a full description: "eam/alloy/opt"_pair_eam.html, "eam/fs"_pair_eam.html, "eam/fs/opt"_pair_eam.html, +"eim"_pair_eim.html, "gayberne"_pair_gayberne.html, "gayberne/gpu"_pair_gayberne.html, "gran/hertz/history"_pair_gran.html, diff --git a/doc/Section_intro.html b/doc/Section_intro.html index 4129f7e9eb..acbe342747 100644 --- a/doc/Section_intro.html +++ b/doc/Section_intro.html @@ -137,7 +137,7 @@ commands)

  • pairwise potentials: Lennard-Jones, Buckingham, Morse, Yukawa, soft, class 2 (COMPASS), tabulated
  • charged pairwise potentials: Coulombic, point-dipole -
  • manybody potentials: EAM, Finnis/Sinclair EAM, modified EAM (MEAM), Stillinger-Weber, Tersoff, AI-REBO, ReaxFF, COMB +
  • manybody potentials: EAM, Finnis/Sinclair EAM, modified EAM (MEAM), embedded ion method (EIM), Stillinger-Weber, Tersoff, AI-REBO, ReaxFF, COMB
  • coarse-grained potentials: DPD, GayBerne, REsquared, colloidal, DLVO
  • mesoscopic potentials: granular, Peridynamics
  • bond potentials: harmonic, FENE, Morse, nonlinear, class 2, quartic (breakable) diff --git a/doc/Section_intro.txt b/doc/Section_intro.txt index 65cbae4965..daf1b6bf8b 100644 --- a/doc/Section_intro.txt +++ b/doc/Section_intro.txt @@ -134,7 +134,7 @@ commands) Yukawa, soft, class 2 (COMPASS), tabulated charged pairwise potentials: Coulombic, point-dipole manybody potentials: EAM, Finnis/Sinclair EAM, modified EAM (MEAM), \ - Stillinger-Weber, Tersoff, AI-REBO, ReaxFF, COMB + embedded ion method (EIM), Stillinger-Weber, Tersoff, AI-REBO, ReaxFF, COMB coarse-grained potentials: DPD, GayBerne, REsquared, colloidal, DLVO mesoscopic potentials: granular, Peridynamics bond potentials: harmonic, FENE, Morse, nonlinear, class 2, \ diff --git a/doc/pair_coeff.html b/doc/pair_coeff.html index 85bb19b861..de26f20bbf 100644 --- a/doc/pair_coeff.html +++ b/doc/pair_coeff.html @@ -106,6 +106,7 @@ the pair_style command, and coefficients specified by the associated
  • pair_style eam/alloy/opt - optimized version of alloy EAM
  • pair_style eam/fs - Finnis-Sinclair EAM
  • pair_style eam/fs/opt - optimized version of Finnis-Sinclair EAM +
  • pair_style eim - embedded ion method (EIM)
  • pair_style gayberne - Gay-Berne ellipsoidal potential
  • pair_style gayberne/gpu - GPU-enabled Gay-Berne ellipsoidal potential
  • pair_style gran/hertz/history - granular potential with Hertzian interactions diff --git a/doc/pair_coeff.txt b/doc/pair_coeff.txt index e925a3d7b1..9fb12c8342 100644 --- a/doc/pair_coeff.txt +++ b/doc/pair_coeff.txt @@ -103,6 +103,7 @@ the pair_style command, and coefficients specified by the associated "pair_style eam/alloy/opt"_pair_eam.html - optimized version of alloy EAM "pair_style eam/fs"_pair_eam.html - Finnis-Sinclair EAM "pair_style eam/fs/opt"_pair_eam.html - optimized version of Finnis-Sinclair EAM +"pair_style eim"_pair_eim.html - embedded ion method (EIM) "pair_style gayberne"_pair_gayberne.html - Gay-Berne ellipsoidal potential "pair_style gayberne/gpu"_pair_gayberne.html - GPU-enabled Gay-Berne ellipsoidal potential "pair_style gran/hertz/history"_pair_gran.html - granular potential with Hertzian interactions diff --git a/doc/pair_eim.html b/doc/pair_eim.html new file mode 100644 index 0000000000..cfeead5d92 --- /dev/null +++ b/doc/pair_eim.html @@ -0,0 +1,153 @@ + +
    LAMMPS WWW Site - LAMMPS Documentation - LAMMPS Commands +
    + + + + + + +
    + +

    pair_style eim command +

    +

    Syntax: +

    +
    pair_style style 
    +
    +
    • style = eim +
    +

    Examples: +

    +
    pair_style eim
    +pair_coeff * * Na Cl ../potentials/ffield.eim Na Cl
    +pair_coeff * * Na Cl ffield.eim  Na Na Na Cl
    +pair_coeff * * Na Cl ../potentials/ffield.eim Cl NULL Na 
    +
    +

    Description: +

    +

    Style eim computes pairwise interactions for ionic compounds +using embedded-ion method (EIM) potentials (Zhou). The +energy of the system E is given by +

    +
    +
    +

    The first term is a double pairwise sum over the J neighbors of all I +atoms, where phi_ij is a pair potential. The second term sums over +the embedding energy E_i of atom I, which is a function of its charge +q_i and the electrical potential sigma_i at its location. E_i, q_i, +and sigma_i are calculated as +

    +
    +
    +

    where eta_ji is a pairwise function describing electron flow from atom +I to atom J, and psi_ij is another pairwise function. The multi-body +nature of the EIM potential is a result of the embedding energy term. +A complete list of all the pair functions used in EIM is summarized +below +

    +
    +
    +

    Here E_b, r_e, r_(c,phi), alpha, beta, A_(psi), zeta, r_(s,psi), +r_(c,psi), A_(eta), r_(s,eta), r_(c,eta), chi, and pair function type +p are parameters, with subscripts ij indicating the two species of +atoms in the atomic pair. +

    +

    IMPORTANT NOTE: Even though the EIM potential is treating atoms as +charged ions, you should not use a LAMMPS atom_style +that stores a charge on each atom and thus requires you to assign a +charge to each atom, e.g. the charge or full atom styles. This is +because the EIM potential infers the charge on an atom from the +equation above for q_i; you do not assign charges explicitly. +

    +
    + +

    All the EIM parameters are listed in a potential file which is +specified by the pair_coeff command. This is an +ASCII text file in a format described below. The "ffield.eim" file +included in the "potentials" directory of the LAMMPS distribution +currently includes nine elements Li, Na, K, Rb, Cs, F, Cl, Br, and I. +A system with any combination of these elements can be modeled. This +file is parameterized in terms of LAMMPS metal units. +

    +

    Note that unlike other potentials, cutoffs for EIM potentials are not +set in the pair_style or pair_coeff command; they are specified in the +EIM potential file itself. Likewise, the EIM potential file lists +atomic masses; thus you do not need to use the mass +command to specify them. +

    +

    Only a single pair_coeff command is used with the eim style which +specifies an EIM potential file and the element(s) to extract +information for. The EIM elements 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: +

    +
    • Elem1, Elem2, ... +
    • EIM potential file +
    • N element names = mapping of EIM elements to atom types +
    +

    As an example like one of those above, suppose you want to model a +system with Na and Cl atoms. If your LAMMPS simulation has 4 atoms +types and you want the 1st 3 to be Na, and the 4th to be Cl, you would +use the following pair_coeff command: +

    +
    pair_coeff * * Na Cl ffield.eim Na Na Na Cl 
    +
    +

    The 1st 2 arguments must be * * so as to span all LAMMPS atom types. +The filename is the EIM potential file. The Na and Cl arguments +(before the file name) are the two elements for which info will be +extracted from the potentail file. The first three trailing Na +arguments map LAMMPS atom types 1,2,3 to the EIM Na element. The +final Cl argument maps LAMMPS atom type 4 to the EIM Cl element. +

    +

    If a mapping value is specified as NULL, the mapping is not performed. +This can be used when an eim potential is used as part of the +hybrid pair style. The NULL values are placeholders for atom types +that will be used with other potentials. +

    +

    The ffield.eim file in the potentials directory of the LAMMPS +distribution is formated as follows: +

    +

    Lines starting with # are comments and are ignored by LAMMPS. Lines +starting with "global:" include three global values. The first value +divides the cations from anions, i.e., any elements with +electronegativity above this value are viewed as anions, and any +elements with electronegativity below this value are viewed as +cations. The second and third values are related to the cutoff +function - i.e. the 0.510204, 1.64498, and 0.010204 shown in the above +equation can be derived from these values. +

    +

    Lines starting with "element:" are formatted as follows: name of +element, atomic number, atomic mass, electronic negativity, atomic +radius (LAMMPS ignores it), ionic radius (LAMMPS ignores it), cohesive +energy (LAMMPS ignores it), and q0 (must be 0). +

    +

    Lines starting with "pair:" are entered as: element 1, element 2, +r_(c,phi), r_(c,phi) (redundant for historical reasons), E_b, r_e, +alpha, beta, r_(c,eta), A_(eta), r_(s,eta), r_(c,psi), A_(psi), zeta, +r_(s,psi), and p. +

    +

    The lines in the file can be in any order; LAMMPS extracts the info it +needs. +

    +
    + +

    Restrictions: +

    +

    This style is part of the "manybody" package. It is only enabled if +LAMMPS was built with that package (which it is by default). +

    +

    Related commands: +

    +

    pair_coeff +

    +

    Default: none +

    +
    + + + +

    (Zhou) Zhou, submitted for publication (2010). Please contact +Xiaowang Zhou (Sandia) for details via email at xzhou at sandia.gov. +

    + diff --git a/doc/pair_eim.txt b/doc/pair_eim.txt new file mode 100644 index 0000000000..411f64c254 --- /dev/null +++ b/doc/pair_eim.txt @@ -0,0 +1,147 @@ +"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c + +:link(lws,http://lammps.sandia.gov) +:link(ld,Manual.html) +:link(lc,Section_commands.html#comm) + +:line + +pair_style eim command :h3 + +[Syntax:] + +pair_style style :pre + +style = {eim} :ul + +[Examples:] + +pair_style eim +pair_coeff * * Na Cl ../potentials/ffield.eim Na Cl +pair_coeff * * Na Cl ffield.eim Na Na Na Cl +pair_coeff * * Na Cl ../potentials/ffield.eim Cl NULL Na :pre + +[Description:] + +Style {eim} computes pairwise interactions for ionic compounds +using embedded-ion method (EIM) potentials "(Zhou)"_#Zhou. The +energy of the system E is given by + +:c,image(Eqs/pair_eim1.jpg) + +The first term is a double pairwise sum over the J neighbors of all I +atoms, where phi_ij is a pair potential. The second term sums over +the embedding energy E_i of atom I, which is a function of its charge +q_i and the electrical potential sigma_i at its location. E_i, q_i, +and sigma_i are calculated as + +:c,image(Eqs/pair_eim2.jpg) + +where eta_ji is a pairwise function describing electron flow from atom +I to atom J, and psi_ij is another pairwise function. The multi-body +nature of the EIM potential is a result of the embedding energy term. +A complete list of all the pair functions used in EIM is summarized +below + +:c,image(Eqs/pair_eim3.jpg) + +Here E_b, r_e, r_(c,phi), alpha, beta, A_(psi), zeta, r_(s,psi), +r_(c,psi), A_(eta), r_(s,eta), r_(c,eta), chi, and pair function type +p are parameters, with subscripts ij indicating the two species of +atoms in the atomic pair. + +IMPORTANT NOTE: Even though the EIM potential is treating atoms as +charged ions, you should not use a LAMMPS "atom_style"_atom_style.html +that stores a charge on each atom and thus requires you to assign a +charge to each atom, e.g. the {charge} or {full} atom styles. This is +because the EIM potential infers the charge on an atom from the +equation above for q_i; you do not assign charges explicitly. + +:line + +All the EIM parameters are listed in a potential file which is +specified by the "pair_coeff"_pair_coeff.html command. This is an +ASCII text file in a format described below. The "ffield.eim" file +included in the "potentials" directory of the LAMMPS distribution +currently includes nine elements Li, Na, K, Rb, Cs, F, Cl, Br, and I. +A system with any combination of these elements can be modeled. This +file is parameterized in terms of LAMMPS "metal units"_units.html. + +Note that unlike other potentials, cutoffs for EIM potentials are not +set in the pair_style or pair_coeff command; they are specified in the +EIM potential file itself. Likewise, the EIM potential file lists +atomic masses; thus you do not need to use the "mass"_mass.html +command to specify them. + +Only a single pair_coeff command is used with the {eim} style which +specifies an EIM potential file and the element(s) to extract +information for. The EIM elements 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: + +Elem1, Elem2, ... +EIM potential file +N element names = mapping of EIM elements to atom types :ul + +As an example like one of those above, suppose you want to model a +system with Na and Cl atoms. If your LAMMPS simulation has 4 atoms +types and you want the 1st 3 to be Na, and the 4th to be Cl, you would +use the following pair_coeff command: + +pair_coeff * * Na Cl ffield.eim Na Na Na Cl :pre + +The 1st 2 arguments must be * * so as to span all LAMMPS atom types. +The filename is the EIM potential file. The Na and Cl arguments +(before the file name) are the two elements for which info will be +extracted from the potentail file. The first three trailing Na +arguments map LAMMPS atom types 1,2,3 to the EIM Na element. The +final Cl argument maps LAMMPS atom type 4 to the EIM Cl element. + +If a mapping value is specified as NULL, the mapping is not performed. +This can be used when an {eim} potential is used as part of the +{hybrid} pair style. The NULL values are placeholders for atom types +that will be used with other potentials. + +The ffield.eim file in the {potentials} directory of the LAMMPS +distribution is formated as follows: + +Lines starting with # are comments and are ignored by LAMMPS. Lines +starting with "global:" include three global values. The first value +divides the cations from anions, i.e., any elements with +electronegativity above this value are viewed as anions, and any +elements with electronegativity below this value are viewed as +cations. The second and third values are related to the cutoff +function - i.e. the 0.510204, 1.64498, and 0.010204 shown in the above +equation can be derived from these values. + +Lines starting with "element:" are formatted as follows: name of +element, atomic number, atomic mass, electronic negativity, atomic +radius (LAMMPS ignores it), ionic radius (LAMMPS ignores it), cohesive +energy (LAMMPS ignores it), and q0 (must be 0). + +Lines starting with "pair:" are entered as: element 1, element 2, +r_(c,phi), r_(c,phi) (redundant for historical reasons), E_b, r_e, +alpha, beta, r_(c,eta), A_(eta), r_(s,eta), r_(c,psi), A_(psi), zeta, +r_(s,psi), and p. + +The lines in the file can be in any order; LAMMPS extracts the info it +needs. + +:line + +[Restrictions:] + +This style is part of the "manybody" package. It is only enabled if +LAMMPS was built with that package (which it is by default). + +[Related commands:] + +"pair_coeff"_pair_coeff.html + +[Default:] none + +:line + +:link(Zhou) +[(Zhou)] Zhou, submitted for publication (2010). Please contact +Xiaowang Zhou (Sandia) for details via email at xzhou at sandia.gov. diff --git a/doc/pair_style.html b/doc/pair_style.html index c1002bb0e4..88957d663f 100644 --- a/doc/pair_style.html +++ b/doc/pair_style.html @@ -108,6 +108,7 @@ the pair_style command, and coefficients specified by the associated
  • pair_style eam/alloy/opt - optimized version of alloy EAM
  • pair_style eam/fs - Finnis-Sinclair EAM
  • pair_style eam/fs/opt - optimized version of Finnis-Sinclair EAM +
  • pair_style eim - embedded ion method (EIM)
  • pair_style gayberne - Gay-Berne ellipsoidal potential
  • pair_style gayberne/gpu - GPU-enabled Gay-Berne ellipsoidal potential
  • pair_style gran/hertz/history - granular potential with Hertzian interactions diff --git a/doc/pair_style.txt b/doc/pair_style.txt index b81009646f..fb2bac99f1 100644 --- a/doc/pair_style.txt +++ b/doc/pair_style.txt @@ -105,6 +105,7 @@ the pair_style command, and coefficients specified by the associated "pair_style eam/alloy/opt"_pair_eam.html - optimized version of alloy EAM "pair_style eam/fs"_pair_eam.html - Finnis-Sinclair EAM "pair_style eam/fs/opt"_pair_eam.html - optimized version of Finnis-Sinclair EAM +"pair_style eim"_pair_eim.html - embedded ion method (EIM) "pair_style gayberne"_pair_gayberne.html - Gay-Berne ellipsoidal potential "pair_style gayberne/gpu"_pair_gayberne.html - GPU-enabled Gay-Berne ellipsoidal potential "pair_style gran/hertz/history"_pair_gran.html - granular potential with Hertzian interactions