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

git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@15218 f3b2605a-c512-4ea7-a41b-209d697bcdaa

Browse Source
This commit is contained in:
sjplimp
2016-06-27 22:32:39 +00:00
parent b58e008cae
commit 1c05f57bcd
10 changed files with 130 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
doc/html/_sources/pair_reax_c.txt
View File

@ -3,6 +3,9 @@
pair_style reax/c command
=========================
pair_style reax/c/kk command
============================
Syntax
""""""
@ -46,6 +49,14 @@ the most up-to-date version of ReaxFF as of summer 2010. For more
technical details about the pair reax/c implementation of ReaxFF, see
the :ref:`(Aktulga) <Aktulga>` paper.
The *reax/c/kk* style is a Kokkos version of the ReaxFF potential that is
derived from the *reax/c* style. The Kokkos version can run on GPUs and
can also use OpenMP multithreading. For more information about the Kokkos package,
see :ref:`Section_packages <kokkos>` and :doc:`Section_accelerate <accelerate_kokkos>`.
One important consideration when using the *reax/c/kk* style is the choice of either
half or full neighbor lists. This setting can be changed using the Kokkos :doc:`package <package>`
command.
The *reax/c* style differs from the :doc:`pair_style reax <pair_reax>`
command in the lo-level implementation details. The *reax* style is a
Fortran library, linked to LAMMPS. The *reax/c* style was initially
@ -124,9 +135,11 @@ control file. Note: Force field files are different for the original
or lg corrected pair styles, using wrong ffield file generates an error message.
Optional keywords *safezone* and *mincap* are used for allocating
reax/c arrays. Increase these values can avoid memory problems, such
reax/c arrays. Increasing these values can avoid memory problems, such
as segmentation faults and bondchk failed errors, that could occur under
certain conditions.
certain conditions. These keywords aren't used by the Kokkos version, which
instead uses a more robust memory allocation scheme that checks if the sizes of
the arrays have been exceeded and automatically allocates more memory.
The thermo variable *evdwl* stores the sum of all the ReaxFF potential
energy contributions, with the exception of the Coulombic and charge
@ -287,6 +300,33 @@ This pair style can only be used via the *pair* keyword of the
:doc:`run_style respa <run_style>` command. It does not support the
*inner*\ , *middle*\ , *outer* keywords.
----------
Styles with a *gpu*\ , *intel*\ , *kk*\ , *omp*\ , or *opt* 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 :doc:`Section_accelerate <Section_accelerate>`
of the manual. The accelerated styles take the same arguments and
should produce the same results, except for round-off and precision
issues.
These accelerated styles are part of the GPU, USER-INTEL, KOKKOS,
USER-OMP and OPT packages, respectively. They are only enabled if
LAMMPS was built with those packages. See the :ref:`Making LAMMPS <start_3>` section for more info.
You can specify the accelerated styles explicitly in your input script
by including their suffix, or you can use the :ref:`-suffix command-line switch <start_7>` when you invoke LAMMPS, or you can
use the :doc:`suffix <suffix>` command in your input script.
See :doc:`Section_accelerate <Section_accelerate>` of the manual for
more instructions on how to use the accelerated styles effectively.
----------
Restrictions
""""""""""""