203 lines
6.8 KiB
ReStructuredText
203 lines
6.8 KiB
ReStructuredText
.. index:: pair_style born/coul/dsf/cs
|
|
.. index:: pair_style born/coul/long/cs
|
|
.. index:: pair_style born/coul/long/cs/gpu
|
|
.. index:: pair_style born/coul/wolf/cs
|
|
.. index:: pair_style born/coul/wolf/cs/gpu
|
|
.. index:: pair_style buck/coul/long/cs
|
|
.. index:: pair_style coul/long/cs
|
|
.. index:: pair_style coul/long/cs/gpu
|
|
.. index:: pair_style coul/wolf/cs
|
|
.. index:: pair_style lj/cut/coul/long/cs
|
|
.. index:: pair_style lj/class2/coul/long/cs
|
|
|
|
pair_style born/coul/dsf/cs command
|
|
===================================
|
|
|
|
pair_style born/coul/long/cs command
|
|
====================================
|
|
|
|
Accelerator Variants: *born/coul/long/cs/gpu*
|
|
|
|
pair_style born/coul/wolf/cs command
|
|
====================================
|
|
|
|
Accelerator Variants: *born/coul/wolf/cs/gpu*
|
|
|
|
pair_style buck/coul/long/cs command
|
|
====================================
|
|
|
|
pair_style coul/long/cs command
|
|
===============================
|
|
|
|
Accelerator Variants: *coul/long/cs/gpu*
|
|
|
|
pair_style coul/wolf/cs command
|
|
===============================
|
|
|
|
pair_style lj/cut/coul/long/cs command
|
|
======================================
|
|
|
|
pair_style lj/class2/coul/long/cs command
|
|
=========================================
|
|
|
|
Syntax
|
|
""""""
|
|
|
|
.. code-block:: LAMMPS
|
|
|
|
pair_style style args
|
|
|
|
* style = *born/coul/dsf/cs* or *born/coul/long/cs* or *born/coul/wolf/cs* or *buck/coul/long/cs* or *coul/long/cs* or *coul/wolf/cs* or *lj/cut/coul/long/cs* or *lj/class2/coul/long/cs*
|
|
* args = list of arguments for a particular style
|
|
|
|
.. parsed-literal::
|
|
|
|
*born/coul/dsf/cs* args = alpha cutoff (cutoff2)
|
|
alpha = damping parameter (inverse distance units)
|
|
cutoff = global cutoff for non-Coulombic (and Coulombic if only 1 arg) (distance units)
|
|
cutoff2 = global cutoff for Coulombic (distance units)
|
|
*born/coul/long/cs* args = cutoff (cutoff2)
|
|
cutoff = global cutoff for non-Coulombic (and Coulombic if only 1 arg) (distance units)
|
|
cutoff2 = global cutoff for Coulombic (optional) (distance units)
|
|
*born/coul/wolf/cs* args = alpha cutoff (cutoff2)
|
|
alpha = damping parameter (inverse distance units)
|
|
cutoff = global cutoff for Buckingham (and Coulombic if only 1 arg) (distance units)
|
|
cutoff2 = global cutoff for Coulombic (optional) (distance units)
|
|
*buck/coul/long/cs* args = cutoff (cutoff2)
|
|
cutoff = global cutoff for Buckingham (and Coulombic if only 1 arg) (distance units)
|
|
cutoff2 = global cutoff for Coulombic (optional) (distance units)
|
|
*coul/long* args = cutoff
|
|
cutoff = global cutoff for Coulombic (distance units)
|
|
*coul/wolf* args = alpha cutoff
|
|
alpha = damping parameter (inverse distance units)
|
|
cutoff = global cutoff for Coulombic (distance units)
|
|
*lj/cut/coul/long/cs* args = cutoff (cutoff2)
|
|
cutoff = global cutoff for LJ (and Coulombic if only 1 arg) (distance units)
|
|
cutoff2 = global cutoff for Coulombic (optional) (distance units)
|
|
*lj/class2/coul/long/cs* args = cutoff (cutoff2)
|
|
cutoff = global cutoff for LJ (and Coulombic if only 1 arg) (distance units)
|
|
cutoff2 = global cutoff for Coulombic (optional) (distance units)
|
|
|
|
Examples
|
|
""""""""
|
|
|
|
.. code-block:: LAMMPS
|
|
|
|
pair_style born/coul/dsf/cs 0.1 10.0 12.0
|
|
pair_coeff * * 0.0 1.00 0.00 0.00 0.00
|
|
pair_coeff 1 1 480.0 0.25 0.00 1.05 0.50
|
|
|
|
pair_style born/coul/long/cs 10.0 8.0
|
|
pair_coeff 1 1 6.08 0.317 2.340 24.18 11.51
|
|
|
|
pair_style born/coul/wolf/cs 0.25 10.0 12.0
|
|
pair_coeff * * 0.0 1.00 0.00 0.00 0.00
|
|
pair_coeff 1 1 480.0 0.25 0.00 1.05 0.50
|
|
|
|
pair_style buck/coul/long/cs 10.0
|
|
pair_style buck/coul/long/cs 10.0 8.0
|
|
pair_coeff * * 100.0 1.5 200.0
|
|
pair_coeff 1 1 100.0 1.5 200.0 9.0
|
|
|
|
pair_style coul/long/cs 10.0
|
|
pair_coeff * *
|
|
|
|
pair_style coul/wolf/cs 0.2 9.0
|
|
pair_coeff * *
|
|
|
|
pair_style lj/cut/coul/long/cs 10.0
|
|
pair_style lj/cut/coul/long/cs 10.0 8.0
|
|
pair_coeff * * 100.0 3.0
|
|
pair_coeff 1 1 100.0 3.5 9.0
|
|
|
|
Description
|
|
"""""""""""
|
|
|
|
These pair styles are designed to be used with the adiabatic
|
|
core/shell model of :ref:`(Mitchell and Fincham) <MitchellFincham3>`. See
|
|
the :doc:`Howto coreshell <Howto_coreshell>` page for an overview of
|
|
the model as implemented in LAMMPS.
|
|
|
|
All the styles are identical to the corresponding pair style without
|
|
the "/cs" in the name:
|
|
|
|
* :doc:`pair_style born/coul/dsf <pair_born>`
|
|
* :doc:`pair_style born/coul/long <pair_born>`
|
|
* :doc:`pair_style born/coul/wolf <pair_born>`
|
|
* :doc:`pair_style buck/coul/long <pair_buck>`
|
|
* :doc:`pair_style coul/long <pair_coul>`
|
|
* :doc:`pair_style coul/wolf <pair_coul>`
|
|
* :doc:`pair_style lj/cut/coul/long <pair_lj_cut_coul>`
|
|
* :doc:`pair_style lj/class2/coul/long <pair_class2>`
|
|
|
|
except that they correctly treat the special case where the distance
|
|
between two charged core and shell atoms in the same core/shell pair
|
|
approach r = 0.0.
|
|
|
|
Styles with a "/long" in the name are used with a long-range solver
|
|
for Coulombic interactions via the :doc:`kspace_style <kspace_style>`
|
|
command. They require special treatment of the short-range Coulombic
|
|
interactions within the cor/shell model.
|
|
|
|
Specifically, the short-range Coulomb interaction between a core and
|
|
its shell should be turned off using the
|
|
:doc:`special_bonds <special_bonds>` command by setting the 1-2 weight
|
|
to 0.0, which works because the core and shell atoms are bonded to
|
|
each other. This induces a long-range correction approximation which
|
|
fails at small distances (~< 10e-8). Therefore, the Coulomb term which
|
|
is used to calculate the correction factor is extended by a minimal
|
|
distance (r_min = 1.0-6) when the interaction between a core/shell
|
|
pair is treated, as follows
|
|
|
|
.. math::
|
|
|
|
E = \frac{C q_i q_j}{\epsilon (r + r_{min})} \qquad r \rightarrow 0
|
|
|
|
where C is an energy-conversion constant, :math:`q_i` and :math:`q_j`
|
|
are the charges on the core and shell, epsilon is the dielectric
|
|
constant and :math:`r_{min}` is the minimal distance.
|
|
|
|
For styles that are not used with a long-range solver, i.e. those with
|
|
"/dsf" or "/wolf" in the name, the only correction is the addition of
|
|
a minimal distance to avoid the possible r = 0.0 case for a core/shell
|
|
pair.
|
|
|
|
----------
|
|
|
|
.. include:: accel_styles.rst
|
|
|
|
----------
|
|
|
|
Mixing, shift, table, tail correction, restart, rRESPA info
|
|
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
|
|
|
|
See the corresponding doc pages for pair styles without the "cs"
|
|
suffix to see how mixing, shifting, tabulation, tail correction,
|
|
restarting, and rRESPA are handled by theses pair styles.
|
|
|
|
----------
|
|
|
|
Restrictions
|
|
""""""""""""
|
|
|
|
These pair styles are part of the CORESHELL package. They are only
|
|
enabled if LAMMPS was built with that package. See the :doc:`Build package <Build_package>` page for more info.
|
|
|
|
Related commands
|
|
""""""""""""""""
|
|
|
|
:doc:`pair_coeff <pair_coeff>`, :doc:`pair_style born <pair_born>`,
|
|
:doc:`pair_style buck <pair_buck>`
|
|
|
|
Default
|
|
"""""""
|
|
|
|
none
|
|
|
|
----------
|
|
|
|
.. _MitchellFincham3:
|
|
|
|
**(Mitchell and Fincham)** Mitchell, Fincham, J Phys Condensed Matter,
|
|
5, 1031-1038 (1993).
|