ICODE-ADC/lammps
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

improve grammar and use terms consistent with the rest of LAMMPS

Browse Source
This commit is contained in:
Axel Kohlmeyer
2021-02-28 23:20:02 -05:00
parent cac03a85f3
commit a7e5f1acf2
1 changed files with 114 additions and 112 deletions
Download Patch File Download Diff File Expand all files Collapse all files

112
doc/src/pair_lj_relres.rst
View File

@ -13,10 +13,10 @@ Syntax
pair_style lj/relres Rsi Rso Rci Rco
* Rsi = inner switching distance between the fine-grained and coarse-grained potentials (distance units)
* Rso = outer switching distance between the fine-grained and coarse-grained potentials (distance units)
* Rci = inner cutting distance beyond which the force smoothing for all interactions is applied (distance units)
* Rco = outer cutting distance for all interactions (distance units)
* Rsi = inner cutoff for switching between the fine-grained and coarse-grained potentials (distance units)
* Rso = outer cutoff for switching between the fine-grained and coarse-grained potentials (distance units)
* Rci = inner cutoff beyond which the force smoothing for all interactions is applied (distance units)
* Rco = outer cutoff distance for all interactions (distance units)
Examples
""""""""
@ -30,13 +30,13 @@ Examples
Description
"""""""""""
Style *lj/relres* computes a LJ interaction using the Relative Resolution
(RelRes) framework which applies a fine-grained (FG) potential between near
neighbors and a coarse-grained (CG) potential between far neighbors
:ref:`(Chaimovich1) <Chaimovich1>`. The approach improves the computational
efficiency by almost an order of magnitude, while maintaining the correct
static and dynamic behavior of a reference system
:ref:`(Chaimovich2) <Chaimovich2>`.
Pair style *lj/relres* computes a LJ interaction using the Relative
Resolution (RelRes) framework which applies a fine-grained (FG)
potential between near neighbors and a coarse-grained (CG) potential
between far neighbors :ref:`(Chaimovich1) <Chaimovich1>`. This approach
can improve the computational efficiency by almost an order of
magnitude, while maintaining the correct static and dynamic behavior of
a reference system :ref:`(Chaimovich2) <Chaimovich2>`.
.. math::
@ -52,14 +52,14 @@ The FG parameters of the LJ potential (:math:`\epsilon^{FG}` and
:math:`r_{si}`, while the CG parameters of the LJ potential
(:math:`\epsilon^{CG}` and :math:`\sigma^{CG}`) are applied beyond the
outer switching distance, :math:`r_{so}`. Between :math:`r_{si}` and
:math:`r_{so}` a polynomial smoothing is applied in a way that the force,
together with its derivative, is continuous between the FG and CG potentials.
An analogous smoothing is applied between the inner and outer cutting
distances (:math:`r_{ci}` and :math:`r_{co}`). The shifting constants
:math:`\Gamma_{si}`, :math:`\Gamma_{so}` and :math:`\Gamma_{c}` ensure
the continuity of the energy over the entire domain.
The corresponding polynomial coefficients :math:`\gamma_{sm}` and
:math:`\gamma_{cm}`, as well as the shifting constants, are automatically
:math:`r_{so}` a polynomial smoothing function is applied so that the
force and its derivative are continuous between the FG and CG
potentials. An analogous smoothing function is applied between the
inner and outer cutoff distances (:math:`r_{ci}` and :math:`r_{co}`).
The offsets :math:`\Gamma_{si}`, :math:`\Gamma_{so}` and
:math:`\Gamma_{c}` ensure the continuity of the energy over the entire
domain. The corresponding polynomial coefficients :math:`\gamma_{sm}`
and :math:`\gamma_{cm}`, as well as the offsets are automatically
computed by LAMMPS.
.. note::
@ -67,11 +67,11 @@ computed by LAMMPS.
Energy and force resulting from this methodology can be plotted via the
:doc:`pair_write <pair_write>` command.
The following coefficients must be defined for each pair of atom
types via the :doc:`pair_coeff <pair_coeff>` command as in the examples
above, or in the data file or restart files read by the
:doc:`read_data <read_data>` or :doc:`read_restart <read_restart>`
commands, or by mixing as will be described below:
The following coefficients must be defined for each pair of atom types
via the :doc:`pair_coeff <pair_coeff>` command as in the examples above,
or in the data file or restart files read by the :doc:`read_data
<read_data>` or :doc:`read_restart <read_restart>` commands, or by
mixing as will be described below:
* :math:`\epsilon^{FG}` (energy units)
* :math:`\sigma^{FG}` (distance units)
@ -88,10 +88,10 @@ a particular set of atom types:
* :math:`r_{co}` (distance units)
These parameters are optional, and they are used to override the global
switching/cutting distances as defined in the pair_style command. If not
specified, the global values for :math:`r_{si}`, :math:`r_{so}`,
:math:`r_{ci}`, and :math:`r_{co}` are used. If this override option is
employed, all four arguments must be specified.
cutoffs as defined in the pair_style command. If not specified, the
global values for :math:`r_{si}`, :math:`r_{so}`, :math:`r_{ci}`, and
:math:`r_{co}` are used. If this override option is employed, all four
arguments must be specified.
----------
@ -99,27 +99,29 @@ Here are some guidelines for using the pair_style *lj/relres* command.
At the most basic level in the RelRes framework, groups of atoms must be
defined (even before utilizing the *lj/relres* pair style):
The atoms within each group must be bonded between each other, and
The atoms within each group must be bonded to each other, and
preferably, no two of these atoms are separated by more than two bonds.
One of the atoms in a group (typically the central one) is the "hybrid" site:
It embodies both FG and CG models. Conversely, all other atoms in a group
(typically the peripheral ones) are the "ordinary" sites: They embody just FG
characteristics with no CG features.
Importantly, the computational efficiency of RelRes substantially depends on
the mapping ratio (the number of sites grouped together). For a mapping
ratio of 3, the efficiency factor is around 4, and for a mapping ratio of 5,
the efficiency factor is around 5 :ref:`(Chaimovich2) <Chaimovich2>`.
The computational efficiency of RelRes substantially depends on the
mapping ratio (the number of sites grouped together). For a mapping
ratio of 3, the efficiency factor is around 4, and for a mapping ratio
of 5, the efficiency factor is around 5 :ref:`(Chaimovich2)
<Chaimovich2>`.
The flexibility of LAMMPS allows placing any values for the LJ parameters
in the input script. However, here are the optimal recommendations for the
RelRes parameters, which yield the correct structural and thermal behavior
in a system of interest :ref:`(Chaimovich1) <Chaimovich1>`. Foremost, one
must presume a set of parameters for the FG interactions that applies for
all atom types. Regarding the parameters for the CG interactions, the rules
rely on the site category (if it is a hybrid or an ordinary site). For atom
types of ordinary sites, :math:`\epsilon^{CG}` must be set to 0 (zero) while
the specific value of :math:`\sigma^{CG}` is irrelevant. For atom types of
The flexibility of LAMMPS allows placing any values for the LJ
parameters in the input script. However, here are the optimal
recommendations for the RelRes parameters, which yield the correct
structural and thermal behavior in a system of interest
:ref:`(Chaimovich1) <Chaimovich1>`. One must first assign a complete set of
parameters for the FG interactions that are applicable to all atom types.
Regarding the parameters for the CG interactions, the rules rely on the
site category (if it is a hybrid or an ordinary site). For atom types of
ordinary sites, :math:`\epsilon^{CG}` must be set to 0 (zero) while the
specific value of :math:`\sigma^{CG}` is irrelevant. For atom types of
hybrid sites, the CG parameters should be generally calculated using the
following equations:
@ -134,21 +136,21 @@ where :math:`I` is an atom type of a hybrid site of a particular group
all of its atoms :math:`\alpha`. This equation is the monopole term in the
underlying Taylor series, and it is indeed relevant only if
geometric mixing is applicable for the FG model; if this is not the case,
Ref. :ref:`(Chaimovich2) <Chaimovich2>` discusses the alternative option,
and in such situations, the pair_coeff command should be explicitly defined
Ref. :ref:`(Chaimovich2) <Chaimovich2>` discusses alternative options,
and in such situations the pair_coeff command should be explicitly used
for all combinations of atom types :math:`I\;!=J`.
The switching distance is another crucial parameter in RelRes. Decreasing it
improves the computational efficiency, yet if it is too small, the molecular
simulations may be deficient in capturing the system behavior. As a rule of
thumb, the switching distance should be approximately
:math:`\,\sim\! 1.5\sigma` :ref:`(Chaimovich1) <Chaimovich1>`; thorough
recommendations can be found in Ref. :ref:`(Chaimovich2) <Chaimovich2>`.
Regarding the smoothing zone itself, :math:`\,\sim\! 0.1\sigma`
is recommended; if desired, it can be eliminated by setting the inner
switching distance, :math:`r_{si}`, equal to the outer switching distance,
:math:`r_{so}` (the same is true for the cutting distances :math:`r_{ci}` and
:math:`r_{co}`).
The switching distance is another crucial parameter in RelRes:
decreasing it improves the computational efficiency, yet if it is too
small, the molecular simulations may not capture the system behavior
correctly. As a rule of thumb, the switching distance should be
approximately :math:`\,\sim\! 1.5\sigma` :ref:`(Chaimovich1)
<Chaimovich1>`; recommendations can be found in Ref. :ref:`(Chaimovich2)
<Chaimovich2>`. Regarding the smoothing zone itself, :math:`\,\sim\!
0.1\sigma` is recommended; if desired, switching can be eliminated by setting
the inner switching cutoff, :math:`r_{si}`, equal to the outer
switching cutoff, :math:`r_{so}` (the same is true for the other cutoffs
:math:`r_{ci}` and :math:`r_{co}`).
----------