| ASPHERE |
aspherical particles |
@@ -241,7 +271,7 @@ either via the make command or the Make.py tool described in | BODY |
+| BODY |
body-style particles |
@@ -254,7 +284,7 @@ either via the make command or the Make.py tool described in | CLASS2 |
+| CLASS2 |
class 2 force fields |
@@ -270,7 +300,7 @@ either via the make command or the Make.py tool described in | COLLOID |
+| COLLOID |
colloidal particles |
@@ -283,7 +313,7 @@ either via the make command or the Make.py tool described in | COMPRESS |
+| COMPRESS |
I/O compression |
Axel Kohlmeyer (Temple U) |
dump */gz |
@@ -296,7 +326,7 @@ either via the make command or the Make.py tool described in CORESHELL |
+ | CORESHELL |
adiabatic core/shell model |
Hendrik Heenen (Technical U of Munich) |
Section_howto 6.25 |
@@ -306,7 +336,7 @@ either via the make command or the Make.py tool described in DIPOLE |
+ | DIPOLE |
point dipole particles |
@@ -319,7 +349,7 @@ either via the make command or the Make.py tool described in | FLD |
+| FLD |
Fast Lubrication Dynamics |
Kumar & Bybee & Higdon (1) |
pair_style lubricateU |
@@ -332,14 +362,14 @@ either via the make command or the Make.py tool described in GPU |
+ | GPU |
GPU-enabled styles |
Mike Brown (ORNL) |
Section accelerate |
gpu |
lib/gpu |
-| GRANULAR |
+ | GRANULAR |
granular systems |
@@ -352,21 +382,21 @@ either via the make command or the Make.py tool described in | KIM |
+| KIM |
openKIM potentials |
Smirichinski & Elliot & Tadmor (3) |
pair_style kim |
kim |
KIM |
-| KOKKOS |
+ | KOKKOS |
Kokkos-enabled styles |
Trott & Edwards (4) |
Section_accelerate |
kokkos |
lib/kokkos |
-| KSPACE |
+ | KSPACE |
long-range Coulombic solvers |
@@ -379,7 +409,7 @@ either via the make command or the Make.py tool described in | MANYBODY |
+| MANYBODY |
many-body potentials |
@@ -392,14 +422,14 @@ either via the make command or the Make.py tool described in | MEAM |
+| MEAM |
modified EAM potential |
Greg Wagner (Sandia) |
pair_style meam |
meam |
lib/meam |
-| MC |
+ | MC |
Monte Carlo options |
@@ -415,7 +445,7 @@ either via the make command or the Make.py tool described in | MOLECULE |
+| MOLECULE |
molecular system force fields |
@@ -428,7 +458,7 @@ either via the make command or the Make.py tool described in | OPT |
+| OPT |
optimized pair styles |
Fischer & Richie & Natoli (2) |
Section accelerate |
@@ -441,7 +471,7 @@ either via the make command or the Make.py tool described in PERI |
+ | PERI |
Peridynamics models |
Mike Parks (Sandia) |
pair_style peri |
@@ -451,14 +481,14 @@ either via the make command or the Make.py tool described in POEMS |
+ | POEMS |
coupled rigid body motion |
Rudra Mukherjee (JPL) |
fix poems |
rigid |
lib/poems |
-| PYTHON |
+ | PYTHON |
embed Python code in an input script |
@@ -468,14 +498,14 @@ either via the make command or the Make.py tool described in | REAX |
+| REAX |
ReaxFF potential |
Aidan Thompson (Sandia) |
pair_style reax |
reax |
lib/reax |
-| REPLICA |
+ | REPLICA |
multi-replica methods |
@@ -488,7 +518,7 @@ either via the make command or the Make.py tool described in | RIGID |
+| RIGID |
rigid bodies |
@@ -501,7 +531,7 @@ either via the make command or the Make.py tool described in | SHOCK |
+| SHOCK |
shock loading methods |
@@ -517,7 +547,7 @@ either via the make command or the Make.py tool described in | SNAP |
+| SNAP |
quantum-fit potential |
Aidan Thompson (Sandia) |
pair snap |
@@ -527,7 +557,7 @@ either via the make command or the Make.py tool described in SRD |
+ | SRD |
stochastic rotation dynamics |
@@ -540,7 +570,7 @@ either via the make command or the Make.py tool described in | VORONOI |
+| VORONOI |
Voronoi tesselations |
Daniel Schwen (LANL) |
compute voronoi/atom |
@@ -550,7 +580,7 @@ either via the make command or the Make.py tool described in XTC |
+ | XTC |
dumps in XTC format |
@@ -576,9 +606,7 @@ either via the make command or the Make.py tool described in Section_howto of the manual, or an input script
-command implemented as part of the package.
+command implemented as part of the package, or to additional
+documentation provided within the package.
The “Example” column is a sub-directory in the examples directory of
the distribution which has an input script that uses the package.
E.g. “peptide” refers to the examples/peptide directory.
@@ -601,74 +630,755 @@ lib/package, then the code for the library is under the lib directory
of the LAMMPS distribution. See the lib/package/README file for info
on how to build the library. If it is not listed as lib/package, then
it is a third-party library not included in the LAMMPS distribution.
-See the src/package/README or src/package/Makefile.lammps file for
-info on where to download the library. Section start of the manual also gives details
-on how to build LAMMPS with both kinds of auxiliary libraries.
-Except where explained below, all of these packages can be installed,
-and LAMMPS re-built, by issuing these commands from the src dir.
-make yes-package
+See details on all of this below for individual packages.
+
+
+
+ 4.2. ASPHERE package
+ Contents: Aspherical particle models for ellipsoids, 2d lines, 3d
+triangles.
+ To install via make or Make.py:
+ make yes-asphere
make machine
-or
-Make.py -p package -a machine
- To un-install the package and re-build LAMMPS without it:
- make no-package
-make machine
-or
-Make.py -p ^package -a machine
+Make.py -p asphere -a machine
-“Package” is the name of the package in lower-case letters,
-e.g. asphere or rigid, and “machine” is the build target, e.g. mpi or
-serial.
+To un-install via make or Make.py:
+make no-asphere
+make machine
+
-
- 4.2. Build instructions for COMPRESS package
+ Make.py -p ^asphere -a machine
+
-
- 4.3. Build instructions for GPU package
+ Supporting info: examples/ASPHERE, examples/ellipse, Section howto
+6.14, pair gayberne
+
-
- 4.4. Build instructions for KIM package
+
+ 4.3. BODY package
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
-
- 4.5. Build instructions for KOKKOS package
+ Make.py -p body -a machine
+
-
- 4.6. Build instructions for KSPACE package
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
-
- 4.7. Build instructions for MEAM package
+ Make.py -p ^body -a machine
+
-
- 4.8. Build instructions for POEMS package
+ Supporting info: examples/body
+
-
- 4.9. Build instructions for PYTHON package
+
+ 4.4. CLASS2 package
+ Contents:
+ To install via make or Make.py:
+ make yes-class2
+make machine
+
-
- 4.10. Build instructions for REAX package
+ Make.py -p class2 -a machine
+
-
- 4.11. Build instructions for VORONOI package
+ To un-install via make or Make.py:
+ make no-class2
+make machine
+
-
- 4.12. Build instructions for XTC package
+ Make.py -p ^class2 -a machine
+
+
+ Supporting info:
+
+
+
+ 4.5. COLLOID package
+ Contents:
+ To install via make or Make.py:
+ make yes-colloid
+make machine
+
+
+ Make.py -p colloid -a machine
+
+
+ To un-install via make or Make.py:
+ make no-colloid
+make machine
+
+
+ Make.py -p ^colloid -a machine
+
+
+ Supporting info: examples/colloid, examples/srd
+
+
+
+ 4.6. COMPRESS package
+ Contents:
+ To install via make or Make.py:
+ make yes-compress
+make machine
+
+
+ Make.py -p compress -a machine
+
+
+ To un-install via make or Make.py:
+ make no-compress
+make machine
+
+
+ Make.py -p ^compress -a machine
+
+
+ Supporting info:
+
+
+
+ 4.7. CORESHELL package
+ Contents:
+ To install via make or Make.py:
+ make yes-coreshell
+make machine
+
+
+ Make.py -p coreshell -a machine
+
+
+ To un-install via make or Make.py:
+ make no-coreshell
+make machine
+
+
+ Make.py -p ^coreshell -a machine
+
+
+ Supporting info: examples/coreshell, Section howto 6.26
+
+
+
+ 4.8. DIPOLE package
+ Contents:
+ To install via make or Make.py:
+ make yes-dipole
+make machine
+
+
+ Make.py -p dipole -a machine
+
+
+ To un-install via make or Make.py:
+ make no-dipole
+make machine
+
+
+ Make.py -p ^dipole -a machine
+
+
+ Supporting info: examples/dipole
+
+
+
+ 4.9. FLD package
+ Contents:
+ To install via make or Make.py:
+ make yes-fld
+make machine
+
+
+ Make.py -p fld -a machine
+
+
+ To un-install via make or Make.py:
+ make no-fld
+make machine
+
+
+ Make.py -p ^fld -a machine
+
+
+ Supporting info:
+
+
+
+ 4.10. GPU package
+ Contents:
+ To install via make or Make.py:
+ make yes-gpu
+make machine
+
+
+ Make.py -p gpu -a machine
+
+
+ To un-install via make or Make.py:
+ make no-gpu
+make machine
+
+
+ Make.py -p ^gpu -a machine
+
+
+ Supporting info: examples/accelerate, bench/FERMI, bench/KEPLER
+
+
+
+ 4.11. GRANULAR package
+ Contents:
+ To install via make or Make.py:
+ make yes-granular
+make machine
+
+
+ Make.py -p granular -a machine
+
+
+ To un-install via make or Make.py:
+ make no-granular
+make machine
+
+
+ Make.py -p ^granular -a machine
+
+
+ Supporting info: examples/pour, bench/in.chute, Section howto 6.6
+
+
+
+ 4.12. KIM package
+ Contents:
+ To install via make or Make.py:
+ make yes-kim
+make machine
+
+
+ Make.py -p kim -a machine
+
+
+ To un-install via make or Make.py:
+ make no-kim
+make machine
+
+
+ Make.py -p ^kim -a machine
+
+
+ Supporting info: examples/kim
+
+
+
+ 4.13. KOKKOS package
+ Contents:
+ To install via make or Make.py:
+ make yes-kokkow
+make machine
+
+
+ Make.py -p kokkow -a machine
+
+
+ To un-install via make or Make.py:
+ make no-kokkow
+make machine
+
+
+ Make.py -p ^kokkow -a machine
+
+
+ Supporting info:
+ For the KOKKOS package, you have 3 choices when building. You can
+build with OMP or Cuda or Phi support. Phi support uses Xeon Phi
+chips in “native” mode. This can be done by setting the following
+variables in your Makefile.machine:
+
+- for OMP support, set OMP = yes
+- for Cuda support, set OMP = yes and CUDA = yes
+- for Phi support, set OMP = yes and MIC = yes
+
+ These can also be set as additional arguments to the make command, e.g.
+ make g++ OMP=yes MIC=yes
+
+
+ Building the KOKKOS package with CUDA support requires a Makefile
+machine that uses the NVIDIA “nvcc” compiler, as well as an
+appropriate “arch” setting appropriate to the GPU hardware and NVIDIA
+software you have on your machine. See
+src/MAKE/OPTIONS/Makefile.kokkos_cuda for an example of such a machine
+Makefile.
+ Examples: examples/accelerate, bench/FERMI, bench/KEPLER
+
+
+
+ 4.14. KSPACE package
+ Contents:
+ To install via make or Make.py:
+ make yes-kspace
+make machine
+
+
+ Make.py -p kspace -a machine
+
+
+ To un-install via make or Make.py:
+ make no-kspace
+make machine
+
+
+ Make.py -p ^kspace -a machine
+
+
+ Supporting info:
+ Examples: examples/peptide, bench/in.rhodo
+ Doc: Section howto 6.7, Section howto 6.8, Section howto 6.9
+
+
+
+ 4.15. MANYBODY package
+ Contents:
+ To install via make or Make.py:
+ make yes-manybody
+make machine
+
+
+ Make.py -p manybody -a machine
+
+
+ To un-install via make or Make.py:
+ make no-manybody
+make machine
+
+
+ Make.py -p ^manybody -a machine
+
+
+ Supporting info:
+ Examples: examples/comb, examples/eim, examples/nb3d, examples/vashishta
+
+
+
+ 4.16. MC package
+ Contents:
+ To install via make or Make.py:
+ make yes-mc
+make machine
+
+
+ Make.py -p mc -a machine
+
+
+ To un-install via make or Make.py:
+ make no-mc
+make machine
+
+
+ Make.py -p ^mc -a machine
+
+
+ Supporting info:
+
+
+
+ 4.17. MEAM package
+ Contents:
+ To install via make or Make.py:
+ make yes-meam
+make machine
+
+
+ Make.py -p meam -a machine
+
+
+ To un-install via make or Make.py:
+ make no-meam
+make machine
+
+
+ Make.py -p ^meam -a machine
+
+
+ Supporting info: examples/meam
+
+
+
+ 4.18. MISC package
+ Contents:
+ To install via make or Make.py:
+ make yes-misc
+make machine
+
+
+ Make.py -p misc -a machine
+
+
+ To un-install via make or Make.py:
+ make no-misc
+make machine
+
+
+ Make.py -p ^misc -a machine
+
+
+ Supporting info: examples/misc
+
+
+
+ 4.19. MOLECULE package
+ Contents:
+ To install via make or Make.py:
+ make yes-molecule
+make machine
+
+
+ Make.py -p molecule -a machine
+
+
+ To un-install via make or Make.py:
+ make no-molecule
+make machine
+
+
+ Make.py -p ^molecule -a machine
+
+
+ Supporting info: examples/micelle, examples/peptide, bench/in.chain, bench/in.rhodo, Section howto 6.3
+
+
+
+ 4.20. MPIIO package
+ Contents:
+ To install via make or Make.py:
+ make yes-mpiio
+make machine
+
+
+ Make.py -p mpiio -a machine
+
+
+ To un-install via make or Make.py:
+ make no-mpiio
+make machine
+
+
+ Make.py -p ^mpiio -a machine
+
+
+ Supporting info:
+
+
+
+ 4.21. OPT package
+ Contents:
+ To install via make or Make.py:
+ make yes-opt
+make machine
+
+
+ Make.py -p opt -a machine
+
+
+ To un-install via make or Make.py:
+ make no-opt
+make machine
+
+
+ Make.py -p ^opt -a machine
+
+
+ Supporting info: examples/accelerate, bench/KEPLER
+ For the OPT package, your Makefile.machine needs an additional
+settings for CCFLAGS.
+
+- CCFLAGS: add -restrict
+
+
+
+
+ 4.22. PERI package
+ Contents:
+ To install via make or Make.py:
+ make yes-peri
+make machine
+
+
+ Make.py -p peri -a machine
+
+
+ To un-install via make or Make.py:
+ make no-peri
+make machine
+
+
+ Make.py -p ^peri -a machine
+
+
+ Supporting info: examples/peri
+
+
+
+ 4.23. POEMS package
+ Contents:
+ To install via make or Make.py:
+ make yes-poems
+make machine
+
+
+ Make.py -p poems -a machine
+
+
+ To un-install via make or Make.py:
+ make no-poems
+make machine
+
+
+ Make.py -p ^poems -a machine
+
+
+ Supporting info: examples/rigid
+
+
+
+ 4.24. PYTHON package
+ Contents:
+ To install via make or Make.py:
+ make yes-python
+make machine
+
+
+ Make.py -p python -a machine
+
+
+ To un-install via make or Make.py:
+ make no-python
+make machine
+
+
+ Make.py -p ^python -a machine
+
+
+ Supporting info: examples/python
+
+
+
+ 4.25. QEQ package
+ Contents:
+ To install via make or Make.py:
+ make yes-qeq
+make machine
+
+
+ Make.py -p qeq -a machine
+
+
+ To un-install via make or Make.py:
+ make no-qeq
+make machine
+
+
+ Make.py -p ^qeq -a machine
+
+
+ Supporting info: examples/qeq
+
+
+
+ 4.26. REAX package
+ Contents:
+ To install via make or Make.py:
+ make yes-reax
+make machine
+
+
+ Make.py -p reax -a machine
+
+
+ To un-install via make or Make.py:
+ make no-reax
+make machine
+
+
+ Make.py -p ^reax -a machine
+
+
+ Supporting info: examples/reax
+
+
+
+ 4.27. REPLICA package
+ Contents:
+ To install via make or Make.py:
+ make yes-replica
+make machine
+
+
+ Make.py -p replica -a machine
+
+
+ To un-install via make or Make.py:
+ make no-replica
+make machine
+
+
+ Make.py -p ^replica -a machine
+
+
+ Supporting info: examples/neb, examples/prd, examples/tad, Section howto 6.5
+
+
+
+ 4.28. RIGID package
+ Contents:
+ To install via make or Make.py:
+ make yes-rigid
+make machine
+
+
+ Make.py -p rigid -a machine
+
+
+ To un-install via make or Make.py:
+ make no-rigid
+make machine
+
+
+ Make.py -p ^rigid -a machine
+
+
+ Supporting info: examples/ASPHERE, examples/rigid
+
+
+
+ 4.29. SHOCK package
+ Contents:
+ To install via make or Make.py:
+ make yes-shock
+make machine
+
+
+ Make.py -p shock -a machine
+
+
+ To un-install via make or Make.py:
+ make no-shock
+make machine
+
+
+ Make.py -p ^shock -a machine
+
+
+ Supporting info: examples/hugoniostat, examples/msst
+
+
+
+ 4.30. SNAP package
+ Contents:
+ To install via make or Make.py:
+ make yes-snap
+make machine
+
+
+ Make.py -p snap -a machine
+
+
+ To un-install via make or Make.py:
+ make no-snap
+make machine
+
+
+ Make.py -p ^snap -a machine
+
+
+ Supporting info: examples/snap
+
+
+
+ 4.31. SRD package
+ Contents:
+ To install via make or Make.py:
+ make yes-srd
+make machine
+
+
+ Make.py -p srd -a machine
+
+
+ To un-install via make or Make.py:
+ make no-srd
+make machine
+
+
+ Make.py -p ^srd -a machine
+
+
+ Supporting info:
+
+
+
+ 4.32. VORONOI package
+ Contents:
+ To install via make or Make.py:
+ make yes-voronoi
+make machine
+
+
+ Make.py -p voronoi -a machine
+
+
+ To un-install via make or Make.py:
+ make no-voronoi
+make machine
+
+
+ Make.py -p ^voronoi -a machine
+
+
+ Supporting info: examples/voronoi
+
+
+
+ 4.33. XTC package
+ Contents:
+ To install via make or Make.py:
+ make yes-xtc
+make machine
+
+
+ Make.py -p xtc -a machine
+
+
+ To un-install via make or Make.py:
+ make no-xtc
+make machine
+
+
+ Make.py -p ^xtc -a machine
+
+
+ Supporting info:
- 4.13. User packages
+ 4.34. User packages
The current list of user-contributed packages is as follows:
-
-
-
-
-
-
-
+
+
+
+
+
+
+
| Package |
@@ -679,7 +1389,7 @@ serial.
Pic/movie |
Library |
-| USER-ATC |
+ | USER-ATC |
atom-to-continuum coupling |
Jones & Templeton & Zimmerman (1) |
fix atc |
@@ -687,7 +1397,7 @@ serial.
atc |
lib/atc |
-| USER-AWPMD |
+ | USER-AWPMD |
wave-packet MD |
Ilya Valuev (JIHT) |
pair_style awpmd/cut |
@@ -698,7 +1408,7 @@ serial.
lib/awpmd |
-| USER-CG-CMM |
+ | USER-CG-CMM |
coarse-graining model |
Axel Kohlmeyer (Temple U) |
pair_style lj/sdk |
@@ -709,7 +1419,7 @@ serial.
-| USER-COLVARS |
+ | USER-COLVARS |
collective variables |
Fiorin & Henin & Kohlmeyer (2) |
fix colvars |
@@ -717,7 +1427,7 @@ serial.
colvars |
lib/colvars |
-| USER-CUDA |
+ | USER-CUDA |
NVIDIA GPU styles |
Christian Trott (U Tech Ilmenau) |
Section accelerate |
@@ -728,7 +1438,7 @@ serial.
lib/cuda |
-| USER-DIFFRACTION |
+ | USER-DIFFRACTION |
virutal x-ray and electron diffraction |
Shawn Coleman (ARL) |
compute xrd |
@@ -742,7 +1452,7 @@ serial.
-| USER-DPD |
+ | USER-DPD |
dissipative particle dynamics (DPD) |
Larentzos & Mattox & Brennan (5) |
src/USER-DPD/README |
@@ -756,7 +1466,7 @@ serial.
-| USER-DRUDE |
+ | USER-DRUDE |
Drude oscillators |
Dequidt & Devemy & Padua (3) |
tutorial |
@@ -770,7 +1480,7 @@ serial.
-| USER-EFF |
+ | USER-EFF |
electron force field |
Andres Jaramillo-Botero (Caltech) |
pair_style eff/cut |
@@ -781,7 +1491,7 @@ serial.
-| USER-FEP |
+ | USER-FEP |
free energy perturbation |
Agilio Padua (U Blaise Pascal Clermont-Ferrand) |
compute fep |
@@ -795,7 +1505,7 @@ serial.
-| USER-H5MD |
+ | USER-H5MD |
dump output via HDF5 |
Pierre de Buyl (KU Leuven) |
dump h5md |
@@ -809,7 +1519,7 @@ serial.
lib/h5md |
-| USER-INTEL |
+ | USER-INTEL |
Vectorized CPU and Intel(R) coprocessor styles |
- Michael Brown (Intel)
@@ -826,7 +1536,7 @@ serial.
|
-| USER-LB |
+ | USER-LB |
Lattice Boltzmann fluid |
Colin Denniston (U Western Ontario) |
fix lb/fluid |
@@ -840,7 +1550,7 @@ serial.
-| USER-MGPT |
+ | USER-MGPT |
fast MGPT multi-ion potentials |
Tomas Oppelstrup & John Moriarty (LLNL) |
pair_style mgpt |
@@ -854,7 +1564,7 @@ serial.
-| USER-MISC |
+ | USER-MISC |
single-file contributions |
USER-MISC/README |
USER-MISC/README |
@@ -871,7 +1581,7 @@ serial.
-| USER-MOLFILE |
+ | USER-MOLFILE |
VMD molfile plug-ins |
Axel Kohlmeyer (Temple U) |
dump molfile |
@@ -885,7 +1595,7 @@ serial.
VMD-MOLFILE |
-| USER-OMP |
+ | USER-OMP |
OpenMP threaded styles |
Axel Kohlmeyer (Temple U) |
Section accelerate |
@@ -902,7 +1612,7 @@ serial.
-| USER-PHONON |
+ | USER-PHONON |
phonon dynamical matrix |
Ling-Ti Kong (Shanghai Jiao Tong U) |
fix phonon |
@@ -916,7 +1626,7 @@ serial.
-| USER-QMMM |
+ | USER-QMMM |
QM/MM coupling |
Axel Kohlmeyer (Temple U) |
fix qmmm |
@@ -927,7 +1637,7 @@ serial.
lib/qmmm |
-| USER-QTB |
+ | USER-QTB |
quantum nuclear effects |
Yuan Shen (Stanford) |
fix qtb fix_qbmsst |
@@ -941,7 +1651,7 @@ serial.
-| USER-QUIP |
+ | USER-QUIP |
QUIP/libatoms interface |
Albert Bartok-Partay (U Cambridge) |
pair_style quip |
@@ -952,7 +1662,7 @@ serial.
lib/quip |
-| USER-REAXC |
+ | USER-REAXC |
C version of ReaxFF |
Metin Aktulga (LBNL) |
pair_style reaxc |
@@ -966,7 +1676,7 @@ serial.
-| USER-SMD |
+ | USER-SMD |
smoothed Mach dynamics |
Georg Ganzenmuller (EMI) |
userguide.pdf |
@@ -980,7 +1690,7 @@ serial.
-| USER-SMTBQ |
+ | USER-SMTBQ |
Second Moment Tight Binding - QEq potential |
Salles & Maras & Politano & Tetot (4) |
pair_style smtbq |
@@ -994,7 +1704,7 @@ serial.
-| USER-SPH |
+ | USER-SPH |
smoothed particle hydrodynamics |
Georg Ganzenmuller (EMI) |
userguide.pdf |
@@ -1005,7 +1715,7 @@ serial.
-| USER-TALLY |
+ | USER-TALLY |
Pairwise tallied computes |
Axel Kohlmeyer (Temple U) |
compute |
@@ -1019,7 +1729,21 @@ serial.
-| |
+ | USER-VTK |
+VTK-style dumps |
+Berger and Queteschiner (6) |
+compute custom/vtk |
+
+ |
+
+ |
+lib/vtk |
+
+| |
|
|
|
@@ -1041,13 +1765,11 @@ Clermont-Ferrand) and co-authors Julien Devemy (CNRS) and Agilio Padua
(U Blaise Pascal).
(4) The SMTBQ package was created by Nicolas Salles, Emile Maras,
Olivier Politano, and Robert Tetot (LAAS-CNRS, France).
-(4) The USER-DPD package was created by James Larentzos, Timothy
-Mattox, and John Brennan (Army Research Lab (ARL) and Engility Corp).
-If the Library is not listed as lib/package, then it is a third-party
-library not included in the LAMMPS distribution. See the
-src/package/Makefile.lammps file for info on where to download the
-library from.
-The “Doc page” column links to either a portion of the
+ (5) The USER-DPD package was created by James Larentzos (ARL), Timothy
+Mattox (Engility), and John Brennan (ARL).
+(6) The USER-VTK package was created by Richard Berger (JKU) and
+Daniel Queteschiner (DCS Computing).
+The “Doc page” column links to either a sub-section of the
Section_howto of the manual, or an input script
command implemented as part of the package, or to additional
documentation provided within the package.
@@ -1061,31 +1783,15 @@ lib/package, then the code for the library is under the lib directory
of the LAMMPS distribution. See the lib/package/README file for info
on how to build the library. If it is not listed as lib/package, then
it is a third-party library not included in the LAMMPS distribution.
-See the src/package/Makefile.lammps file for info on where to download
-the library. Section start of the
-manual also gives details on how to build LAMMPS with both kinds of
-auxiliary libraries.
-Except where explained below, all of these packages can be installed,
-and LAMMPS re-built, by issuing these commands from the src dir.
-make yes-user-package
-make machine
-or
-Make.py -p package -a machine
-
-
-To un-install the package and re-build LAMMPS without it:
-make no-user-package
-make machine
-or
-Make.py -p ^package -a machine
-
-
-“Package” is the name of the package (in this case without the user
-prefix) in lower-case letters, e.g. drude or phonon, and “machine” is
-the build target, e.g. mpi or serial.
+See details on all of this below for individual packages.
+
- 4.14. USER-ATC package
+ 4.35. USER-ATC package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package implements a “fix atc” command which can be used in a
LAMMPS input script. This fix can be employed to either do concurrent
coupling of MD with FE-based physics surrogates or on-the-fly
@@ -1102,10 +1808,15 @@ libraries.
sandia.gov), Jeremy Templeton (jatempl at sandia.gov) and Jon
Zimmerman (jzimmer at sandia.gov) at Sandia. Contact them directly if
you have questions.
-
+Examples: examples/USER/atc
+
- 4.15. USER-AWPMD package
+ 4.36. USER-AWPMD package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package contains a LAMMPS implementation of the Antisymmetrized
Wave Packet Molecular Dynamics (AWPMD) method.
See the doc page for the pair_style awpmd/cut command to get started.
@@ -1117,10 +1828,29 @@ libraries.
The person who created this package is Ilya Valuev at the JIHT in
Russia (valuev at physik.hu-berlin.de). Contact him directly if you
have questions.
-
+Examples: examples/USER/awpmd
+
- 4.16. USER-CG-CMM package
+ 4.37. USER-CG-CMM package
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Supporting info:
This package implements 3 commands which can be used in a LAMMPS input
script:
@@ -1152,10 +1882,15 @@ have not been testing with all kinds of potential parameters and
simulation systems.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
-
+Examples: examples/USER/cg-cmm
+
- 4.17. USER-COLVARS package
+ 4.38. USER-COLVARS package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package implements the “fix colvars” command which can be
used in a LAMMPS input script.
This fix allows to use “collective variables” to implement
@@ -1181,10 +1916,15 @@ Thus the current version of this package should be considered
beta quality.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
-
+Examples: examples/USER/colvars
+Contents:
+To install via make or Make.py:
+To un-install via make or Make.py:
+Supporting info:
+
- 4.18. USER-CUDA package
+ 4.39. USER-CUDA package
This package provides acceleration of various LAMMPS pair styles, fix
styles, compute styles, and long-range Coulombics via PPPM for NVIDIA
GPUs.
@@ -1199,10 +1939,15 @@ libraries.
The person who created this package is Christian Trott at the
University of Technology Ilmenau, Germany (christian.trott at
tu-ilmenau.de). Contact him directly if you have questions.
-
+Examples: examples/accelerate, bench/FERMI, bench/KEPLER
+Contents:
+To install via make or Make.py:
+To un-install via make or Make.py:
+Supporting info:
+
- 4.19. USER-DIFFRACTION package
+ 4.40. USER-DIFFRACTION package
This package contains the commands neeed to calculate x-ray and
electron diffraction intensities based on kinematic diffraction
theory.
@@ -1215,10 +1960,29 @@ theory.
The person who created this package is Shawn P. Coleman
(shawn.p.coleman8.ctr at mail.mil) while at the University of
Arkansas. Contact him directly if you have questions.
+ Examples: examples/USER/diffraction
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Supporting info:
+
- 4.20. USER-DPD package
+ 4.41. USER-DPD package
This package implements the dissipative particle dynamics (DPD) method
under isothermal, isoenergetic, isobaric and isenthalpic conditions.
The DPD equations of motion are integrated efficiently through the
@@ -1239,10 +2003,31 @@ Shardlow splitting algorithm.
(james.p.larentzos.civ at mail.mil), Timothy Mattox (Timothy.Mattox at
engilitycorp.com) and John Brennan (john.k.brennan.civ at mail.mil).
Contact them directly if you have questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/dpd
+
- 4.21. USER-DRUDE package
+ 4.42. USER-DRUDE package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package implements methods for simulating polarizable systems
in LAMMPS using thermalized Drude oscillators.
See these doc pages and their related commands to get started:
@@ -1259,10 +2044,32 @@ in LAMMPS using thermalized Drude oscillators.
Blaise Pascal Clermont-Ferrand (alain.dequidt at univ-bpclermont.fr)
Contact him directly if you have questions. Co-authors: Julien Devemy,
Agilio Padua.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/drude
+ Doc: Section howto 6.27
+
- 4.22. USER-EFF package
+ 4.43. USER-EFF package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package contains a LAMMPS implementation of the electron Force
Field (eFF) currently under development at Caltech, as described in
A. Jaramillo-Botero, J. Su, Q. An, and W.A. Goddard III, JCC,
@@ -1293,10 +2100,31 @@ examples/USER/eff.
The person who created this package is Andres Jaramillo-Botero at
CalTech (ajaramil at wag.caltech.edu). Contact him directly if you
have questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/eff
+
- 4.23. USER-FEP package
+ 4.44. USER-FEP package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package provides methods for performing free energy perturbation
simulations with soft-core pair potentials in LAMMPS.
See these doc pages and their related commands to get started:
@@ -1308,10 +2136,31 @@ simulations with soft-core pair potentials in LAMMPS.
The person who created this package is Agilio Padua at Universite
Blaise Pascal Clermont-Ferrand (agilio.padua at univ-bpclermont.fr)
Contact him directly if you have questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/fep
+
- 4.24. USER-H5MD package
+ 4.45. USER-H5MD package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package contains a dump h5md command for
performing a dump of atom properties in HDF5 format. HDF5 files are binary, portable and self-describing and can be
examined and used by a variety of auxiliary tools. The output HDF5
@@ -1322,10 +2171,14 @@ citation to a paper describing the format.
The person who created this package and the underlying H5MD format is
Pierre de Buyl at KU Leuven (see http://pdebuyl.be). Contact him
directly if you have questions.
-
+
- 4.25. USER-INTEL package
+ 4.46. USER-INTEL package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package provides options for performing neighbor list and
non-bonded force calculations in single, mixed, or double precision
and also a capability for accelerating calculations with an
@@ -1334,10 +2187,33 @@ Intel(R) Xeon Phi(TM) coprocessor.
Section_accelerate
The person who created this package is W. Michael Brown at Intel
(michael.w.brown at intel.com). Contact him directly if you have questions.
-
+For the USER-INTEL package, you have 2 choices when building. You can
+build with CPU or Phi support. The latter uses Xeon Phi chips in
+“offload” mode. Each of these modes requires additional settings in
+your Makefile.machine for CCFLAGS and LINKFLAGS.
+For CPU mode (if using an Intel compiler):
+
+- CCFLAGS: add -fopenmp, -DLAMMPS_MEMALIGN=64, -restrict, -xHost, -fno-alias, -ansi-alias, -override-limits
+- LINKFLAGS: add -fopenmp
+
+For Phi mode add the following in addition to the CPU mode flags:
+
+- CCFLAGS: add -DLMP_INTEL_OFFLOAD and
+- LINKFLAGS: add -offload
+
+And also add this to CCFLAGS:
+
+-offload-option,mic,compiler,"-fp-model fast=2 -mGLOB_default_function_attrs="gather_scatter_loop_unroll=4""
+
+Examples: examples/accelerate, bench/KEPLER
+
- 4.26. USER-LB package
+ 4.47. USER-LB package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package contains a LAMMPS implementation of a background
Lattice-Boltzmann fluid, which can be used to model MD particles
influenced by hydrodynamic forces.
@@ -1346,10 +2222,31 @@ influenced by hydrodynamic forces.
The people who created this package are Frances Mackay (fmackay at
uwo.ca) and Colin (cdennist at uwo.ca) Denniston, University of
Western Ontario. Contact them directly if you have questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/lb
+
- 4.27. USER-MGPT package
+ 4.48. USER-MGPT package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package contains a fast implementation for LAMMPS of
quantum-based MGPT multi-ion potentials. The MGPT or model GPT method
derives from first-principles DFT-based generalized pseudopotential
@@ -1369,10 +2266,31 @@ Oppelstrup at LLNL.
The persons who created the USER-MGPT package are Tomas Oppelstrup
(oppelstrup2@llnl.gov) and John Moriarty (moriarty2@llnl.gov)
Contact them directly if you have any questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/mgpt
+
- 4.28. USER-MISC package
+ 4.49. USER-MISC package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
The files in this package are a potpourri of (mostly) unrelated
features contributed to LAMMPS by users. Each feature is a single
pair of files (*.cpp and *.h).
@@ -1386,10 +2304,31 @@ compute, pair, etc sections.
src/USER-MISC/README file.
You should contact the author directly if you have specific questions
about the feature or its coding.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/misc
+
- 4.29. USER-MOLFILE package
+ 4.50. USER-MOLFILE package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package contains a dump molfile command which uses molfile
plugins that are bundled with the
VMD molecular visualization and
@@ -1405,10 +2344,14 @@ application itself.
dump molfile
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
-
+
- 4.30. USER-OMP package
+ 4.51. USER-OMP package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package provides OpenMP multi-threading support and
other optimizations of various LAMMPS pair styles, dihedral
styles, and fix styles.
@@ -1416,10 +2359,17 @@ styles, and fix styles.
Section_accelerate
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
-
+For the USER-OMP package, your Makefile.machine needs additional
+settings for CCFLAGS and LINKFLAGS.
+
+- CCFLAGS: add -fopenmp and -restrict
+- LINKFLAGS: add -fopenmp
+
+Examples: examples/accelerate, bench/KEPLER
+
- 4.31. USER-PHONON package
+ 4.52. USER-PHONON package
This package contains a fix phonon command that calculates dynamical
matrices, which can then be used to compute phonon dispersion
relations, directly from molecular dynamics simulations.
@@ -1428,10 +2378,31 @@ relations, directly from molecular dynamics simulations.
The person who created this package is Ling-Ti Kong (konglt at
sjtu.edu.cn) at Shanghai Jiao Tong University. Contact him directly
if you have questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/phonon
+
- 4.32. USER-QMMM package
+ 4.53. USER-QMMM package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package provides a fix qmmm command which allows LAMMPS to be
used in a QM/MM simulation, currently only in combination with pw.x
code from the Quantum ESPRESSO package.
@@ -1445,10 +2416,14 @@ without changes to LAMMPS itself.
as well as the lib/qmmm/README file.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
-
+
- 4.33. USER-QTB package
+ 4.54. USER-QTB package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package provides a self-consistent quantum treatment of the
vibrational modes in a classical molecular dynamics simulation. By
coupling the MD simulation to a colored thermostat, it introduces zero
@@ -1467,10 +2442,54 @@ bath with the shocked system.
The person who created this package is Yuan Shen (sy0302 at
stanford.edu) at Stanford University. Contact him directly if you
have questions.
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Examples: examples/USER/qtb
+
+
+ 4.55. USER-QUIP package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
+ Examples: examples/USER/quip
+
+
- 4.34. USER-REAXC package
+ 4.56. USER-REAXC package
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Supporting info:
This package contains a implementation for LAMMPS of the ReaxFF force
field. ReaxFF uses distance-dependent bond-order functions to
represent the contributions of chemical bonding to the potential
@@ -1495,10 +2514,15 @@ of how to use it in LAMMPS.
at lbl.gov), while at Purdue University. Contact him directly, or
Aidan Thompson at Sandia (athomps at sandia.gov), if you have
questions.
-
+Examples: examples/reax
+
- 4.35. USER-SMD package
+ 4.57. USER-SMD package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
This package implements smoothed Mach dynamics (SMD) in
LAMMPS. Currently, the package has the following features:
@@ -1519,10 +2543,29 @@ from *.STL files.
Fraunhofer-Institute for High-Speed Dynamics, Ernst Mach Institute in
Germany (georg.ganzenmueller at emi.fhg.de). Contact him directly if
you have questions.
-
+Examples: examples/USER/smd
+
- 4.36. USER-SMTBQ package
+ 4.58. USER-SMTBQ package
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Supporting info:
This package implements the Second Moment Tight Binding - QEq (SMTB-Q)
potential for the description of ionocovalent bonds in oxides.
There are example scripts for using this package in
@@ -1533,10 +2576,29 @@ examples/USER/smtbq.
Emile Maras, Olivier Politano, Robert Tetot, who can be contacted at
these email addreses: lammps@u-bourgogne.fr, nsalles@laas.fr. Contact
them directly if you have any questions.
-
+Examples: examples/USER/smtbq
+
- 4.37. USER-SPH package
+ 4.59. USER-SPH package
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Supporting info:
This package implements smoothed particle hydrodynamics (SPH) in
LAMMPS. Currently, the package has the following features:
+
+ 4.60. USER-TALLY package
+ Contents:
+ To install via make or Make.py:
+ make yes-body
+make machine
+
+
+ Make.py -p body -a machine
+
+
+ To un-install via make or Make.py:
+ make no-body
+make machine
+
+
+ Make.py -p ^body -a machine
+
+
+ Supporting info:
+ Examples: examples/USER/tally
+
+
+
+ 4.61. USER-VTK package
+ Contents:
+ To install via make or Make.py:
+ To un-install via make or Make.py:
+ Supporting info:
+ Examples: examples/USER/tally
diff --git a/doc/Section_packages.txt b/doc/Section_packages.txt
index 864c0afd92..43c7a2579f 100644
--- a/doc/Section_packages.txt
+++ b/doc/Section_packages.txt
@@ -10,8 +10,12 @@ Section"_Section_accelerate.html :c
4. Packages :h3
-This section gives a quick overview of the add-on packages that extend
-LAMMPS functionality.
+This section gives an overview of the add-on packages that extend
+LAMMPS functionality. Two tables, for standard and user packages, are
+below. A brief sub-section for each package follows, with a summary
+of what the package contains, how to install it, and pointers to
+examples of its use or documentation provided in the LAMMPS
+distribution.
4.1 "Standard packages"_#pkg_1
4.2 "User packages"_#pkg_2 :all(b)
@@ -41,54 +45,51 @@ the USER-OMP package is already installed, both the pair
lj/cut/coul/long and lj/cut/coul/long/omp commands will be installed.
The two tables below list currently available packages in LAMMPS, with
-a one-line descriptions of each. The sections below give a few more
-details, including instructions for building LAMMPS with the package,
-either via the make command or the Make.py tool described in "Section
-2.4"_Section_start.html#start_4.
+a one-line descriptions of each. The sub-sections below give more
+details.
-:line
:line
4.1 Standard packages :h4,link(pkg_1)
-The current list of standard packages is as follows.
+The current list of standard packages is as follows. Each package
+name links to a sub-section below with more details on how to build
+with the package and pointers to additional info.
Package, Description, Author(s), Doc page, Example, Library
-ASPHERE, aspherical particles, -, "Section_howto 6.14"_Section_howto.html#howto_14, ellipse, -
-BODY, body-style particles, -, "body"_body.html, body, -
-CLASS2, class 2 force fields, -, "pair_style lj/class2"_pair_class2.html, -, -
-COLLOID, colloidal particles, -, "atom_style colloid"_atom_style.html, colloid, -
-COMPRESS, I/O compression, Axel Kohlmeyer (Temple U), "dump */gz"_dump.html, -, -
-CORESHELL, adiabatic core/shell model, Hendrik Heenen (Technical U of Munich), "Section_howto 6.25"_Section_howto.html#howto_25, coreshell, -
-DIPOLE, point dipole particles, -, "pair_style dipole/cut"_pair_dipole.html, dipole, -
-FLD, Fast Lubrication Dynamics, Kumar & Bybee & Higdon (1), "pair_style lubricateU"_pair_lubricateU.html, -, -
-GPU, GPU-enabled styles, Mike Brown (ORNL), "Section accelerate"_accelerate_gpu.html, gpu, lib/gpu
-GRANULAR, granular systems, -, "Section_howto 6.6"_Section_howto.html#howto_6, pour, -
-KIM, openKIM potentials, Smirichinski & Elliot & Tadmor (3), "pair_style kim"_pair_kim.html, kim, KIM
-KOKKOS, Kokkos-enabled styles, Trott & Edwards (4), "Section_accelerate"_accelerate_kokkos.html, kokkos, lib/kokkos
-KSPACE, long-range Coulombic solvers, -, "kspace_style"_kspace_style.html, peptide, -
-MANYBODY, many-body potentials, -, "pair_style tersoff"_pair_tersoff.html, shear, -
-MEAM, modified EAM potential, Greg Wagner (Sandia), "pair_style meam"_pair_meam.html, meam, lib/meam
-MC, Monte Carlo options, -, "fix gcmc"_fix_gcmc.html, -, -
-MOLECULE, molecular system force fields, -, "Section_howto 6.3"_Section_howto.html#howto_3, peptide, -
-OPT, optimized pair styles, Fischer & Richie & Natoli (2), "Section accelerate"_accelerate_opt.html, -, -
-PERI, Peridynamics models, Mike Parks (Sandia), "pair_style peri"_pair_peri.html, peri, -
-POEMS, coupled rigid body motion, Rudra Mukherjee (JPL), "fix poems"_fix_poems.html, rigid, lib/poems
-PYTHON, embed Python code in an input script, -, "python"_python.html, python, lib/python
-REAX, ReaxFF potential, Aidan Thompson (Sandia), "pair_style reax"_pair_reax.html, reax, lib/reax
-REPLICA, multi-replica methods, -, "Section_howto 6.5"_Section_howto.html#howto_5, tad, -
-RIGID, rigid bodies, -, "fix rigid"_fix_rigid.html, rigid, -
-SHOCK, shock loading methods, -, "fix msst"_fix_msst.html, -, -
-SNAP, quantum-fit potential, Aidan Thompson (Sandia), "pair snap"_pair_snap.html, snap, -
-SRD, stochastic rotation dynamics, -, "fix srd"_fix_srd.html, srd, -
-VORONOI, Voronoi tesselations, Daniel Schwen (LANL), "compute voronoi/atom"_compute_voronoi_atom.html, -, Voro++
-XTC, dumps in XTC format, -, "dump"_dump.html, -, -
+"ASPHERE"_#ASPHERE, aspherical particles, -, "Section_howto 6.14"_Section_howto.html#howto_14, ellipse, -
+"BODY"_#BODY, body-style particles, -, "body"_body.html, body, -
+"CLASS2"_#CLASS2, class 2 force fields, -, "pair_style lj/class2"_pair_class2.html, -, -
+"COLLOID"_#COLLOID, colloidal particles, -, "atom_style colloid"_atom_style.html, colloid, -
+"COMPRESS"_#COMPRESS, I/O compression, Axel Kohlmeyer (Temple U), "dump */gz"_dump.html, -, -
+"CORESHELL"_#CORESHELL, adiabatic core/shell model, Hendrik Heenen (Technical U of Munich), "Section_howto 6.25"_Section_howto.html#howto_25, coreshell, -
+"DIPOLE"_#DIPOLE, point dipole particles, -, "pair_style dipole/cut"_pair_dipole.html, dipole, -
+"FLD"_#FLD, Fast Lubrication Dynamics, Kumar & Bybee & Higdon (1), "pair_style lubricateU"_pair_lubricateU.html, -, -
+"GPU"_#GPU, GPU-enabled styles, Mike Brown (ORNL), "Section accelerate"_accelerate_gpu.html, gpu, lib/gpu
+"GRANULAR"_#GRANULAR, granular systems, -, "Section_howto 6.6"_Section_howto.html#howto_6, pour, -
+"KIM"_#KIM, openKIM potentials, Smirichinski & Elliot & Tadmor (3), "pair_style kim"_pair_kim.html, kim, KIM
+"KOKKOS"_#KOKKOS, Kokkos-enabled styles, Trott & Edwards (4), "Section_accelerate"_accelerate_kokkos.html, kokkos, lib/kokkos
+"KSPACE"_#KSPACE, long-range Coulombic solvers, -, "kspace_style"_kspace_style.html, peptide, -
+"MANYBODY"_#MANYBODY, many-body potentials, -, "pair_style tersoff"_pair_tersoff.html, shear, -
+"MEAM"_#MEAM, modified EAM potential, Greg Wagner (Sandia), "pair_style meam"_pair_meam.html, meam, lib/meam
+"MC"_#MC, Monte Carlo options, -, "fix gcmc"_fix_gcmc.html, -, -
+"MOLECULE"_#MOLECULE, molecular system force fields, -, "Section_howto 6.3"_Section_howto.html#howto_3, peptide, -
+"OPT"_#OPT, optimized pair styles, Fischer & Richie & Natoli (2), "Section accelerate"_accelerate_opt.html, -, -
+"PERI"_#PERI, Peridynamics models, Mike Parks (Sandia), "pair_style peri"_pair_peri.html, peri, -
+"POEMS"_#POEMS, coupled rigid body motion, Rudra Mukherjee (JPL), "fix poems"_fix_poems.html, rigid, lib/poems
+"PYTHON"_#PYTHON, embed Python code in an input script, -, "python"_python.html, python, lib/python
+"REAX"_#REAX, ReaxFF potential, Aidan Thompson (Sandia), "pair_style reax"_pair_reax.html, reax, lib/reax
+"REPLICA"_#REPLICA, multi-replica methods, -, "Section_howto 6.5"_Section_howto.html#howto_5, tad, -
+"RIGID"_#RIGID, rigid bodies, -, "fix rigid"_fix_rigid.html, rigid, -
+"SHOCK"_#SHOCK, shock loading methods, -, "fix msst"_fix_msst.html, -, -
+"SNAP"_#SNAP, quantum-fit potential, Aidan Thompson (Sandia), "pair snap"_pair_snap.html, snap, -
+"SRD"_#SRD, stochastic rotation dynamics, -, "fix srd"_fix_srd.html, srd, -
+"VORONOI"_#VORONOI, Voronoi tesselations, Daniel Schwen (LANL), "compute voronoi/atom"_compute_voronoi_atom.html, -, Voro++
+"XTC"_#XTC, dumps in XTC format, -, "dump"_dump.html, -, -
:tb(ea=c)
The "Authors" column lists a name(s) if a specific person is
responible for creating and maintaining the package.
-More details on
-multiple authors are give below.
(1) The FLD package was created by Amit Kumar and Michael Bybee from
Jonathan Higdon's group at UIUC.
@@ -104,9 +105,10 @@ and Ellad Tadmor (U Minn).
(Sandia). It uses the Kokkos library which was developed by Carter
Edwards, Christian, and collaborators at Sandia.
-The "Doc page" column links to either a portion of the
+The "Doc page" column links to either a sub-section of the
"Section_howto"_Section_howto.html of the manual, or an input script
-command implemented as part of the package.
+command implemented as part of the package, or to additional
+documentation provided within the package.
The "Example" column is a sub-directory in the examples directory of
the distribution which has an input script that uses the package.
@@ -118,76 +120,747 @@ lib/package, then the code for the library is under the lib directory
of the LAMMPS distribution. See the lib/package/README file for info
on how to build the library. If it is not listed as lib/package, then
it is a third-party library not included in the LAMMPS distribution.
-See the src/package/README or src/package/Makefile.lammps file for
-info on where to download the library. "Section
-start"_Section_start.html#start_3_3 of the manual also gives details
-on how to build LAMMPS with both kinds of auxiliary libraries.
-
-Except where explained below, all of these packages can be installed,
-and LAMMPS re-built, by issuing these commands from the src dir.
-
-make yes-package
-make machine
-or
-Make.py -p package -a machine :pre
-
-To un-install the package and re-build LAMMPS without it:
-
-make no-package
-make machine
-or
-Make.py -p ^package -a machine :pre
-
-"Package" is the name of the package in lower-case letters,
-e.g. asphere or rigid, and "machine" is the build target, e.g. mpi or
-serial.
-
-:line
-:line
-
-Build instructions for COMPRESS package :h4
+See details on all of this below for individual packages.
:line
-Build instructions for GPU package :h4
+ASPHERE package :link(ASPHERE),h4
+
+Contents: Aspherical particle models for ellipsoids, 2d lines, 3d
+triangles.
+
+To install via make or Make.py:
+
+make yes-asphere
+make machine :pre
+
+Make.py -p asphere -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-asphere
+make machine :pre
+
+Make.py -p ^asphere -a machine :pre
+
+Supporting info: examples/ASPHERE, examples/ellipse, Section howto
+6.14, pair gayberne
:line
-Build instructions for KIM package :h4
+BODY package :link(BODY),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info: examples/body
:line
+
+CLASS2 package :link(CLASS2),h4
-Build instructions for KOKKOS package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-class2
+make machine :pre
+
+Make.py -p class2 -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-class2
+make machine :pre
+
+Make.py -p ^class2 -a machine :pre
+
+Supporting info:
+
+:line
+
+COLLOID package :link(COLLOID),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-colloid
+make machine :pre
+
+Make.py -p colloid -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-colloid
+make machine :pre
+
+Make.py -p ^colloid -a machine :pre
+
+Supporting info: examples/colloid, examples/srd
+
+:line
+
+COMPRESS package :link(COMPRESS),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-compress
+make machine :pre
+
+Make.py -p compress -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-compress
+make machine :pre
+
+Make.py -p ^compress -a machine :pre
+
+Supporting info:
:line
+
+CORESHELL package :link(CORESHELL),h4
-Build instructions for KSPACE package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-coreshell
+make machine :pre
+
+Make.py -p coreshell -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-coreshell
+make machine :pre
+
+Make.py -p ^coreshell -a machine :pre
+
+Supporting info: examples/coreshell, Section howto 6.26
:line
+
+DIPOLE package :link(DIPOLE),h4
-Build instructions for MEAM package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-dipole
+make machine :pre
+
+Make.py -p dipole -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-dipole
+make machine :pre
+
+Make.py -p ^dipole -a machine :pre
+
+Supporting info: examples/dipole
+
+:line
+
+FLD package :link(FLD),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-fld
+make machine :pre
+
+Make.py -p fld -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-fld
+make machine :pre
+
+Make.py -p ^fld -a machine :pre
+
+Supporting info:
+
+:line
+
+GPU package :link(GPU),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-gpu
+make machine :pre
+
+Make.py -p gpu -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-gpu
+make machine :pre
+
+Make.py -p ^gpu -a machine :pre
+
+Supporting info: examples/accelerate, bench/FERMI, bench/KEPLER
+
+:line
+
+GRANULAR package :link(GRANULAR),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-granular
+make machine :pre
+
+Make.py -p granular -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-granular
+make machine :pre
+
+Make.py -p ^granular -a machine :pre
+
+Supporting info: examples/pour, bench/in.chute, Section howto 6.6
+
+:line
+
+KIM package :link(KIM),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-kim
+make machine :pre
+
+Make.py -p kim -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-kim
+make machine :pre
+
+Make.py -p ^kim -a machine :pre
+
+Supporting info: examples/kim
+
+:line
+
+KOKKOS package :link(KOKKOS),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-kokkow
+make machine :pre
+
+Make.py -p kokkow -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-kokkow
+make machine :pre
+
+Make.py -p ^kokkow -a machine :pre
+
+Supporting info:
+
+For the KOKKOS package, you have 3 choices when building. You can
+build with OMP or Cuda or Phi support. Phi support uses Xeon Phi
+chips in "native" mode. This can be done by setting the following
+variables in your Makefile.machine:
+
+for OMP support, set OMP = yes
+for Cuda support, set OMP = yes and CUDA = yes
+for Phi support, set OMP = yes and MIC = yes :ul
+
+These can also be set as additional arguments to the make command, e.g.
+
+make g++ OMP=yes MIC=yes :pre
+
+Building the KOKKOS package with CUDA support requires a Makefile
+machine that uses the NVIDIA "nvcc" compiler, as well as an
+appropriate "arch" setting appropriate to the GPU hardware and NVIDIA
+software you have on your machine. See
+src/MAKE/OPTIONS/Makefile.kokkos_cuda for an example of such a machine
+Makefile.
+
+Examples: examples/accelerate, bench/FERMI, bench/KEPLER
+
+:line
+
+KSPACE package :link(KSPACE),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-kspace
+make machine :pre
+
+Make.py -p kspace -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-kspace
+make machine :pre
+
+Make.py -p ^kspace -a machine :pre
+
+Supporting info:
+
+Examples: examples/peptide, bench/in.rhodo
+
+Doc: Section howto 6.7, Section howto 6.8, Section howto 6.9
:line
+
+MANYBODY package :link(MANYBODY),h4
-Build instructions for POEMS package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-manybody
+make machine :pre
+
+Make.py -p manybody -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-manybody
+make machine :pre
+
+Make.py -p ^manybody -a machine :pre
+
+Supporting info:
+
+Examples: examples/comb, examples/eim, examples/nb3d, examples/vashishta
:line
+
+MC package :link(MC),h4
-Build instructions for PYTHON package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-mc
+make machine :pre
+
+Make.py -p mc -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-mc
+make machine :pre
+
+Make.py -p ^mc -a machine :pre
+
+Supporting info:
+
+:line
+
+MEAM package :link(MEAM),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-meam
+make machine :pre
+
+Make.py -p meam -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-meam
+make machine :pre
+
+Make.py -p ^meam -a machine :pre
+
+Supporting info: examples/meam
+
+:line
+
+MISC package :link(MISC),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-misc
+make machine :pre
+
+Make.py -p misc -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-misc
+make machine :pre
+
+Make.py -p ^misc -a machine :pre
+
+Supporting info: examples/misc
+
+:line
+
+MOLECULE package :link(MOLECULE),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-molecule
+make machine :pre
+
+Make.py -p molecule -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-molecule
+make machine :pre
+
+Make.py -p ^molecule -a machine :pre
+
+Supporting info: examples/micelle, examples/peptide, bench/in.chain, bench/in.rhodo, Section howto 6.3
+
+:line
+
+MPIIO package :link(MPIIO),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-mpiio
+make machine :pre
+
+Make.py -p mpiio -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-mpiio
+make machine :pre
+
+Make.py -p ^mpiio -a machine :pre
+
+Supporting info:
+
+:line
+
+OPT package :link(OPT),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-opt
+make machine :pre
+
+Make.py -p opt -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-opt
+make machine :pre
+
+Make.py -p ^opt -a machine :pre
+
+Supporting info: examples/accelerate, bench/KEPLER
+
+For the OPT package, your Makefile.machine needs an additional
+settings for CCFLAGS.
+
+CCFLAGS: add -restrict :ul
:line
+
+PERI package :link(PERI),h4
-Build instructions for REAX package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-peri
+make machine :pre
+
+Make.py -p peri -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-peri
+make machine :pre
+
+Make.py -p ^peri -a machine :pre
+
+Supporting info: examples/peri
+
+:line
+
+POEMS package :link(POEMS),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-poems
+make machine :pre
+
+Make.py -p poems -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-poems
+make machine :pre
+
+Make.py -p ^poems -a machine :pre
+
+Supporting info: examples/rigid
:line
+
+PYTHON package :link(PYTHON),h4
-Build instructions for VORONOI package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-python
+make machine :pre
+
+Make.py -p python -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-python
+make machine :pre
+
+Make.py -p ^python -a machine :pre
+
+Supporting info: examples/python
+
+:line
+
+QEQ package :link(QEQ),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-qeq
+make machine :pre
+
+Make.py -p qeq -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-qeq
+make machine :pre
+
+Make.py -p ^qeq -a machine :pre
+
+Supporting info: examples/qeq
+
+:line
+
+REAX package :link(REAX),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-reax
+make machine :pre
+
+Make.py -p reax -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-reax
+make machine :pre
+
+Make.py -p ^reax -a machine :pre
+
+Supporting info: examples/reax
+
+:line
+
+REPLICA package :link(REPLICA),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-replica
+make machine :pre
+
+Make.py -p replica -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-replica
+make machine :pre
+
+Make.py -p ^replica -a machine :pre
+
+Supporting info: examples/neb, examples/prd, examples/tad, Section howto 6.5
:line
+
+RIGID package :link(RIGID),h4
-Build instructions for XTC package :h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-rigid
+make machine :pre
+
+Make.py -p rigid -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-rigid
+make machine :pre
+
+Make.py -p ^rigid -a machine :pre
+
+Supporting info: examples/ASPHERE, examples/rigid
:line
+
+SHOCK package :link(SHOCK),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-shock
+make machine :pre
+
+Make.py -p shock -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-shock
+make machine :pre
+
+Make.py -p ^shock -a machine :pre
+
+Supporting info: examples/hugoniostat, examples/msst
+
+:line
+
+SNAP package :link(SNAP),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-snap
+make machine :pre
+
+Make.py -p snap -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-snap
+make machine :pre
+
+Make.py -p ^snap -a machine :pre
+
+Supporting info: examples/snap
+
+:line
+
+SRD package :link(SRD),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-srd
+make machine :pre
+
+Make.py -p srd -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-srd
+make machine :pre
+
+Make.py -p ^srd -a machine :pre
+
+Supporting info:
+
+:line
+
+VORONOI package :link(VORONOI),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-voronoi
+make machine :pre
+
+Make.py -p voronoi -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-voronoi
+make machine :pre
+
+Make.py -p ^voronoi -a machine :pre
+
+Supporting info: examples/voronoi
+
+:line
+
+XTC package :link(XTC),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-xtc
+make machine :pre
+
+Make.py -p xtc -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-xtc
+make machine :pre
+
+Make.py -p ^xtc -a machine :pre
+
+Supporting info:
+
:line
4.2 User packages :h4,link(pkg_2)
@@ -195,32 +868,33 @@ Build instructions for XTC package :h4
The current list of user-contributed packages is as follows:
Package, Description, Author(s), Doc page, Example, Pic/movie, Library
-USER-ATC, atom-to-continuum coupling, Jones & Templeton & Zimmerman (1), "fix atc"_fix_atc.html, USER/atc, "atc"_atc, lib/atc
-USER-AWPMD, wave-packet MD, Ilya Valuev (JIHT), "pair_style awpmd/cut"_pair_awpmd.html, USER/awpmd, -, lib/awpmd
-USER-CG-CMM, coarse-graining model, Axel Kohlmeyer (Temple U), "pair_style lj/sdk"_pair_sdk.html, USER/cg-cmm, "cg"_cg, -
-USER-COLVARS, collective variables, Fiorin & Henin & Kohlmeyer (2), "fix colvars"_fix_colvars.html, USER/colvars, "colvars"_colvars, lib/colvars
-USER-CUDA, NVIDIA GPU styles, Christian Trott (U Tech Ilmenau), "Section accelerate"_accelerate_cuda.html, USER/cuda, -, lib/cuda
-USER-DIFFRACTION, virutal x-ray and electron diffraction, Shawn Coleman (ARL),"compute xrd"_compute_xrd.html, USER/diffraction, -, -
-USER-DPD, dissipative particle dynamics (DPD), Larentzos & Mattox & Brennan (5), src/USER-DPD/README, USER/dpd, -, -
-USER-DRUDE, Drude oscillators, Dequidt & Devemy & Padua (3), "tutorial"_tutorial_drude.html, USER/drude, -, -
-USER-EFF, electron force field, Andres Jaramillo-Botero (Caltech), "pair_style eff/cut"_pair_eff.html, USER/eff, "eff"_eff, -
-USER-FEP, free energy perturbation, Agilio Padua (U Blaise Pascal Clermont-Ferrand), "compute fep"_compute_fep.html, USER/fep, -, -
-USER-H5MD, dump output via HDF5, Pierre de Buyl (KU Leuven), "dump h5md"_dump_h5md.html, -, -, lib/h5md
-USER-INTEL, Vectorized CPU and Intel(R) coprocessor styles, W. Michael Brown (Intel), "Section accelerate"_accelerate_intel.html, examples/intel, -, -
-USER-LB, Lattice Boltzmann fluid, Colin Denniston (U Western Ontario), "fix lb/fluid"_fix_lb_fluid.html, USER/lb, -, -
-USER-MGPT, fast MGPT multi-ion potentials, Tomas Oppelstrup & John Moriarty (LLNL), "pair_style mgpt"_pair_mgpt.html, USER/mgpt, -, -
-USER-MISC, single-file contributions, USER-MISC/README, USER-MISC/README, -, -, -
-USER-MOLFILE, "VMD"_VMD molfile plug-ins, Axel Kohlmeyer (Temple U), "dump molfile"_dump_molfile.html, -, -, VMD-MOLFILE
-USER-OMP, OpenMP threaded styles, Axel Kohlmeyer (Temple U), "Section accelerate"_accelerate_omp.html, -, -, -
-USER-PHONON, phonon dynamical matrix, Ling-Ti Kong (Shanghai Jiao Tong U), "fix phonon"_fix_phonon.html, USER/phonon, -, -
-USER-QMMM, QM/MM coupling, Axel Kohlmeyer (Temple U), "fix qmmm"_fix_qmmm.html, USER/qmmm, -, lib/qmmm
-USER-QTB, quantum nuclear effects, Yuan Shen (Stanford), "fix qtb"_fix_qtb.html "fix_qbmsst"_fix_qbmsst.html, qtb, -, -
-USER-QUIP, QUIP/libatoms interface, Albert Bartok-Partay (U Cambridge), "pair_style quip"_pair_quip.html, USER/quip, -, lib/quip
-USER-REAXC, C version of ReaxFF, Metin Aktulga (LBNL), "pair_style reaxc"_pair_reax_c.html, reax, -, -
-USER-SMD, smoothed Mach dynamics, Georg Ganzenmuller (EMI), "userguide.pdf"_PDF/SMD_LAMMPS_userguide.pdf, USER/smd, -, -
-USER-SMTBQ, Second Moment Tight Binding - QEq potential, Salles & Maras & Politano & Tetot (4), "pair_style smtbq"_pair_smtbq.html, USER/smtbq, -, -
-USER-SPH, smoothed particle hydrodynamics, Georg Ganzenmuller (EMI), "userguide.pdf"_PDF/SPH_LAMMPS_userguide.pdf, USER/sph, "sph"_sph, -
-USER-TALLY, Pairwise tallied computes, Axel Kohlmeyer (Temple U), "compute <...>/tally"_compute_tally.html, USER/tally, -, -
+"USER-ATC"_#USER-ATC, atom-to-continuum coupling, Jones & Templeton & Zimmerman (1), "fix atc"_fix_atc.html, USER/atc, "atc"_atc, lib/atc
+"USER-AWPMD"_#USER-AWPMD, wave-packet MD, Ilya Valuev (JIHT), "pair_style awpmd/cut"_pair_awpmd.html, USER/awpmd, -, lib/awpmd
+"USER-CG-CMM"_#USER-CG-CMM, coarse-graining model, Axel Kohlmeyer (Temple U), "pair_style lj/sdk"_pair_sdk.html, USER/cg-cmm, "cg"_cg, -
+"USER-COLVARS"_#USER-COLVARS, collective variables, Fiorin & Henin & Kohlmeyer (2), "fix colvars"_fix_colvars.html, USER/colvars, "colvars"_colvars, lib/colvars
+"USER-CUDA"_#USER-CUDA, NVIDIA GPU styles, Christian Trott (U Tech Ilmenau), "Section accelerate"_accelerate_cuda.html, USER/cuda, -, lib/cuda
+"USER-DIFFRACTION"_#USER-DIFFRACTION, virutal x-ray and electron diffraction, Shawn Coleman (ARL),"compute xrd"_compute_xrd.html, USER/diffraction, -, -
+"USER-DPD"_#USER-DPD, dissipative particle dynamics (DPD), Larentzos & Mattox & Brennan (5), src/USER-DPD/README, USER/dpd, -, -
+"USER-DRUDE"_#USER-DRUDE, Drude oscillators, Dequidt & Devemy & Padua (3), "tutorial"_tutorial_drude.html, USER/drude, -, -
+"USER-EFF"_#USER-EFF, electron force field, Andres Jaramillo-Botero (Caltech), "pair_style eff/cut"_pair_eff.html, USER/eff, "eff"_eff, -
+"USER-FEP"_#USER-FEP, free energy perturbation, Agilio Padua (U Blaise Pascal Clermont-Ferrand), "compute fep"_compute_fep.html, USER/fep, -, -
+"USER-H5MD"_#USER-H5MD, dump output via HDF5, Pierre de Buyl (KU Leuven), "dump h5md"_dump_h5md.html, -, -, lib/h5md
+"USER-INTEL"_#USER-INTEL, Vectorized CPU and Intel(R) coprocessor styles, W. Michael Brown (Intel), "Section accelerate"_accelerate_intel.html, examples/intel, -, -
+"USER-LB"_#USER-LB, Lattice Boltzmann fluid, Colin Denniston (U Western Ontario), "fix lb/fluid"_fix_lb_fluid.html, USER/lb, -, -
+"USER-MGPT"_#USER-MGPT, fast MGPT multi-ion potentials, Tomas Oppelstrup & John Moriarty (LLNL), "pair_style mgpt"_pair_mgpt.html, USER/mgpt, -, -
+"USER-MISC"_#USER-MISC, single-file contributions, USER-MISC/README, USER-MISC/README, -, -, -
+"USER-MOLFILE"_#USER-MOLFILE, "VMD"_VMD molfile plug-ins, Axel Kohlmeyer (Temple U), "dump molfile"_dump_molfile.html, -, -, VMD-MOLFILE
+"USER-OMP"_#USER-OMP, OpenMP threaded styles, Axel Kohlmeyer (Temple U), "Section accelerate"_accelerate_omp.html, -, -, -
+"USER-PHONON"_#USER-PHONON, phonon dynamical matrix, Ling-Ti Kong (Shanghai Jiao Tong U), "fix phonon"_fix_phonon.html, USER/phonon, -, -
+"USER-QMMM"_#USER-QMMM, QM/MM coupling, Axel Kohlmeyer (Temple U), "fix qmmm"_fix_qmmm.html, USER/qmmm, -, lib/qmmm
+"USER-QTB"_#USER-QTB, quantum nuclear effects, Yuan Shen (Stanford), "fix qtb"_fix_qtb.html "fix_qbmsst"_fix_qbmsst.html, qtb, -, -
+"USER-QUIP"_#USER-QUIP, QUIP/libatoms interface, Albert Bartok-Partay (U Cambridge), "pair_style quip"_pair_quip.html, USER/quip, -, lib/quip
+"USER-REAXC"_#USER-REAXC, C version of ReaxFF, Metin Aktulga (LBNL), "pair_style reaxc"_pair_reax_c.html, reax, -, -
+"USER-SMD"_#USER-SMD, smoothed Mach dynamics, Georg Ganzenmuller (EMI), "userguide.pdf"_PDF/SMD_LAMMPS_userguide.pdf, USER/smd, -, -
+"USER-SMTBQ"_#USER-SMTBQ, Second Moment Tight Binding - QEq potential, Salles & Maras & Politano & Tetot (4), "pair_style smtbq"_pair_smtbq.html, USER/smtbq, -, -
+"USER-SPH"_#USER-SPH, smoothed particle hydrodynamics, Georg Ganzenmuller (EMI), "userguide.pdf"_PDF/SPH_LAMMPS_userguide.pdf, USER/sph, "sph"_sph, -
+"USER-TALLY"_#USER-TALLY, Pairwise tallied computes, Axel Kohlmeyer (Temple U), "compute <...>/tally"_compute_tally.html, USER/tally, -, -
+"USER-VTK"_#USER-VTK, VTK-style dumps, Berger and Queteschiner (6), "compute custom/vtk"_compute_custom_vtk.html, -, -, lib/vtk
:tb(ea=c)
:link(atc,http://lammps.sandia.gov/pictures.html#atc)
@@ -246,15 +920,13 @@ Clermont-Ferrand) and co-authors Julien Devemy (CNRS) and Agilio Padua
(4) The SMTBQ package was created by Nicolas Salles, Emile Maras,
Olivier Politano, and Robert Tetot (LAAS-CNRS, France).
-(4) The USER-DPD package was created by James Larentzos, Timothy
-Mattox, and John Brennan (Army Research Lab (ARL) and Engility Corp).
+(5) The USER-DPD package was created by James Larentzos (ARL), Timothy
+Mattox (Engility), and John Brennan (ARL).
-If the Library is not listed as lib/package, then it is a third-party
-library not included in the LAMMPS distribution. See the
-src/package/Makefile.lammps file for info on where to download the
-library from.
+(6) The USER-VTK package was created by Richard Berger (JKU) and
+Daniel Queteschiner (DCS Computing).
-The "Doc page" column links to either a portion of the
+The "Doc page" column links to either a sub-section of the
"Section_howto"_Section_howto.html of the manual, or an input script
command implemented as part of the package, or to additional
documentation provided within the package.
@@ -270,35 +942,20 @@ lib/package, then the code for the library is under the lib directory
of the LAMMPS distribution. See the lib/package/README file for info
on how to build the library. If it is not listed as lib/package, then
it is a third-party library not included in the LAMMPS distribution.
-See the src/package/Makefile.lammps file for info on where to download
-the library. "Section start"_Section_start.html#start_3_3 of the
-manual also gives details on how to build LAMMPS with both kinds of
-auxiliary libraries.
-
-Except where explained below, all of these packages can be installed,
-and LAMMPS re-built, by issuing these commands from the src dir.
-
-make yes-user-package
-make machine
-or
-Make.py -p package -a machine :pre
-
-To un-install the package and re-build LAMMPS without it:
-
-make no-user-package
-make machine
-or
-Make.py -p ^package -a machine :pre
-
-"Package" is the name of the package (in this case without the user
-prefix) in lower-case letters, e.g. drude or phonon, and "machine" is
-the build target, e.g. mpi or serial.
+See details on all of this below for individual packages.
-:line
:line
-USER-ATC package :h4
+USER-ATC package :link(USER-ATC),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements a "fix atc" command which can be used in a
LAMMPS input script. This fix can be employed to either do concurrent
coupling of MD with FE-based physics surrogates or on-the-fly
@@ -320,10 +977,20 @@ sandia.gov), Jeremy Templeton (jatempl at sandia.gov) and Jon
Zimmerman (jzimmer at sandia.gov) at Sandia. Contact them directly if
you have questions.
+Examples: examples/USER/atc
+
:line
-USER-AWPMD package :h4
+USER-AWPMD package :link(USER-AWPMD),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a LAMMPS implementation of the Antisymmetrized
Wave Packet Molecular Dynamics (AWPMD) method.
@@ -340,10 +1007,30 @@ The person who created this package is Ilya Valuev at the JIHT in
Russia (valuev at physik.hu-berlin.de). Contact him directly if you
have questions.
+Examples: examples/USER/awpmd
+
:line
-USER-CG-CMM package :h4
+USER-CG-CMM package :link(USER-CG-CMM),h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info:
+
This package implements 3 commands which can be used in a LAMMPS input
script:
@@ -381,10 +1068,20 @@ simulation systems.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
+Examples: examples/USER/cg-cmm
+
:line
-USER-COLVARS package :h4
+USER-COLVARS package :link(USER-COLVARS),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements the "fix colvars" command which can be
used in a LAMMPS input script.
@@ -415,9 +1112,19 @@ beta quality.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
+Examples: examples/USER/colvars
+
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
:line
-USER-CUDA package :h4
+USER-CUDA package :link(USER-CUDA),h4
This package provides acceleration of various LAMMPS pair styles, fix
styles, compute styles, and long-range Coulombics via PPPM for NVIDIA
@@ -439,9 +1146,19 @@ The person who created this package is Christian Trott at the
University of Technology Ilmenau, Germany (christian.trott at
tu-ilmenau.de). Contact him directly if you have questions.
+Examples: examples/accelerate, bench/FERMI, bench/KEPLER
+
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
:line
-USER-DIFFRACTION package :h4
+USER-DIFFRACTION package :link(USER-DIFFRACTION),h4
This package contains the commands neeed to calculate x-ray and
electron diffraction intensities based on kinematic diffraction
@@ -457,9 +1174,29 @@ The person who created this package is Shawn P. Coleman
(shawn.p.coleman8.ctr at mail.mil) while at the University of
Arkansas. Contact him directly if you have questions.
+Examples: examples/USER/diffraction
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info:
+
:line
-USER-DPD package :h4
+USER-DPD package :link(USER-DPD),h4
This package implements the dissipative particle dynamics (DPD) method
under isothermal, isoenergetic, isobaric and isenthalpic conditions.
@@ -484,10 +1221,34 @@ The people who created this package are James Larentzos
engilitycorp.com) and John Brennan (john.k.brennan.civ at mail.mil).
Contact them directly if you have questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/dpd
+
:line
-USER-DRUDE package :h4
+USER-DRUDE package :link(USER-DRUDE),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements methods for simulating polarizable systems
in LAMMPS using thermalized Drude oscillators.
@@ -507,10 +1268,36 @@ Blaise Pascal Clermont-Ferrand (alain.dequidt at univ-bpclermont.fr)
Contact him directly if you have questions. Co-authors: Julien Devemy,
Agilio Padua.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/drude
+
+Doc: Section howto 6.27
+
:line
-USER-EFF package :h4
+USER-EFF package :link(USER-EFF),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a LAMMPS implementation of the electron Force
Field (eFF) currently under development at Caltech, as described in
A. Jaramillo-Botero, J. Su, Q. An, and W.A. Goddard III, JCC,
@@ -548,10 +1335,34 @@ The person who created this package is Andres Jaramillo-Botero at
CalTech (ajaramil at wag.caltech.edu). Contact him directly if you
have questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/eff
+
:line
-USER-FEP package :h4
+USER-FEP package :link(USER-FEP),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package provides methods for performing free energy perturbation
simulations with soft-core pair potentials in LAMMPS.
@@ -565,10 +1376,34 @@ The person who created this package is Agilio Padua at Universite
Blaise Pascal Clermont-Ferrand (agilio.padua at univ-bpclermont.fr)
Contact him directly if you have questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/fep
+
:line
-USER-H5MD package :h4
+USER-H5MD package :link(USER-H5MD),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a "dump h5md"_dump_h5md.html command for
performing a dump of atom properties in HDF5 format. "HDF5
files"_HDF5 are binary, portable and self-describing and can be
@@ -586,8 +1421,16 @@ directly if you have questions.
:line
-USER-INTEL package :h4
+USER-INTEL package :link(USER-INTEL),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package provides options for performing neighbor list and
non-bonded force calculations in single, mixed, or double precision
and also a capability for accelerating calculations with an
@@ -600,10 +1443,39 @@ See this section of the manual to get started:
The person who created this package is W. Michael Brown at Intel
(michael.w.brown at intel.com). Contact him directly if you have questions.
+For the USER-INTEL package, you have 2 choices when building. You can
+build with CPU or Phi support. The latter uses Xeon Phi chips in
+"offload" mode. Each of these modes requires additional settings in
+your Makefile.machine for CCFLAGS and LINKFLAGS.
+
+For CPU mode (if using an Intel compiler):
+
+CCFLAGS: add -fopenmp, -DLAMMPS_MEMALIGN=64, -restrict, -xHost, -fno-alias, -ansi-alias, -override-limits
+LINKFLAGS: add -fopenmp :ul
+
+For Phi mode add the following in addition to the CPU mode flags:
+
+CCFLAGS: add -DLMP_INTEL_OFFLOAD and
+LINKFLAGS: add -offload :ul
+
+And also add this to CCFLAGS:
+
+-offload-option,mic,compiler,"-fp-model fast=2 -mGLOB_default_function_attrs=\"gather_scatter_loop_unroll=4\"" :pre
+
+Examples: examples/accelerate, bench/KEPLER
+
:line
-USER-LB package :h4
+USER-LB package :link(USER-LB),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a LAMMPS implementation of a background
Lattice-Boltzmann fluid, which can be used to model MD particles
influenced by hydrodynamic forces.
@@ -616,10 +1488,34 @@ The people who created this package are Frances Mackay (fmackay at
uwo.ca) and Colin (cdennist at uwo.ca) Denniston, University of
Western Ontario. Contact them directly if you have questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/lb
+
:line
-USER-MGPT package :h4
+USER-MGPT package :link(USER-MGPT),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a fast implementation for LAMMPS of
quantum-based MGPT multi-ion potentials. The MGPT or model GPT method
derives from first-principles DFT-based generalized pseudopotential
@@ -644,10 +1540,34 @@ The persons who created the USER-MGPT package are Tomas Oppelstrup
(oppelstrup2@llnl.gov) and John Moriarty (moriarty2@llnl.gov)
Contact them directly if you have any questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/mgpt
+
:line
-USER-MISC package :h4
+USER-MISC package :link(USER-MISC),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
The files in this package are a potpourri of (mostly) unrelated
features contributed to LAMMPS by users. Each feature is a single
pair of files (*.cpp and *.h).
@@ -667,10 +1587,34 @@ src/USER-MISC/README file.
You should contact the author directly if you have specific questions
about the feature or its coding.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/misc
+
:line
-USER-MOLFILE package :h4
+USER-MOLFILE package :link(USER-MOLFILE),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a dump molfile command which uses molfile
plugins that are bundled with the
"VMD"_http://www.ks.uiuc.edu/Research/vmd molecular visualization and
@@ -693,8 +1637,16 @@ The person who created this package is Axel Kohlmeyer at Temple U
:line
-USER-OMP package :h4
+USER-OMP package :link(USER-OMP),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package provides OpenMP multi-threading support and
other optimizations of various LAMMPS pair styles, dihedral
styles, and fix styles.
@@ -706,9 +1658,17 @@ See this section of the manual to get started:
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
+For the USER-OMP package, your Makefile.machine needs additional
+settings for CCFLAGS and LINKFLAGS.
+
+CCFLAGS: add -fopenmp and -restrict
+LINKFLAGS: add -fopenmp :ul
+
+Examples: examples/accelerate, bench/KEPLER
+
:line
-USER-PHONON package :h4
+USER-PHONON package :link(USER-PHONON),h4
This package contains a fix phonon command that calculates dynamical
matrices, which can then be used to compute phonon dispersion
@@ -722,10 +1682,34 @@ The person who created this package is Ling-Ti Kong (konglt at
sjtu.edu.cn) at Shanghai Jiao Tong University. Contact him directly
if you have questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/phonon
+
:line
-USER-QMMM package :h4
+USER-QMMM package :link(USER-QMMM),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package provides a fix qmmm command which allows LAMMPS to be
used in a QM/MM simulation, currently only in combination with pw.x
code from the "Quantum ESPRESSO"_espresso package.
@@ -748,9 +1732,17 @@ The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
:line
-
-USER-QTB package :h4
-
+
+USER-QTB package :link(USER-QTB),h4
+
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package provides a self-consistent quantum treatment of the
vibrational modes in a classical molecular dynamics simulation. By
coupling the MD simulation to a colored thermostat, it introduces zero
@@ -774,10 +1766,58 @@ The person who created this package is Yuan Shen (sy0302 at
stanford.edu) at Stanford University. Contact him directly if you
have questions.
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Examples: examples/USER/qtb
+
:line
-USER-REAXC package :h4
+USER-QUIP package :link(USER-QUIP),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
+Examples: examples/USER/quip
+
+:line
+
+USER-REAXC package :link(USER-REAXC),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info:
+
This package contains a implementation for LAMMPS of the ReaxFF force
field. ReaxFF uses distance-dependent bond-order functions to
represent the contributions of chemical bonding to the potential
@@ -809,10 +1849,20 @@ at lbl.gov), while at Purdue University. Contact him directly, or
Aidan Thompson at Sandia (athomps at sandia.gov), if you have
questions.
+Examples: examples/reax
+
:line
-USER-SMD package :h4
+USER-SMD package :link(USER-SMD),h4
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements smoothed Mach dynamics (SMD) in
LAMMPS. Currently, the package has the following features:
@@ -840,10 +1890,30 @@ Fraunhofer-Institute for High-Speed Dynamics, Ernst Mach Institute in
Germany (georg.ganzenmueller at emi.fhg.de). Contact him directly if
you have questions.
+Examples: examples/USER/smd
+
:line
-USER-SMTBQ package :h4
+USER-SMTBQ package :link(USER-SMTBQ),h4
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info:
+
This package implements the Second Moment Tight Binding - QEq (SMTB-Q)
potential for the description of ionocovalent bonds in oxides.
@@ -859,9 +1929,29 @@ Emile Maras, Olivier Politano, Robert Tetot, who can be contacted at
these email addreses: lammps@u-bourgogne.fr, nsalles@laas.fr. Contact
them directly if you have any questions.
+Examples: examples/USER/smtbq
+
:line
-USER-SPH package :h4
+USER-SPH package :link(USER-SPH),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info:
This package implements smoothed particle hydrodynamics (SPH) in
LAMMPS. Currently, the package has the following features:
@@ -887,3 +1977,43 @@ The person who created this package is Georg Ganzenmuller at the
Fraunhofer-Institute for High-Speed Dynamics, Ernst Mach Institute in
Germany (georg.ganzenmueller at emi.fhg.de). Contact him directly if
you have questions.
+
+Examples: examples/USER/sph
+
+:line
+
+USER-TALLY package :link(USER-TALLY),h4
+
+Contents:
+
+To install via make or Make.py:
+
+make yes-body
+make machine :pre
+
+Make.py -p body -a machine :pre
+
+To un-install via make or Make.py:
+
+make no-body
+make machine :pre
+
+Make.py -p ^body -a machine :pre
+
+Supporting info:
+
+Examples: examples/USER/tally
+
+:line
+
+USER-VTK package :link(USER-VTK),h4
+
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
+Examples: examples/USER/tally
diff --git a/doc/_sources/Section_packages.txt b/doc/_sources/Section_packages.txt
index dee6c8632d..8dc9b753d7 100644
--- a/doc/_sources/Section_packages.txt
+++ b/doc/_sources/Section_packages.txt
@@ -1,8 +1,12 @@
Packages
========
-This section gives a quick overview of the add-on packages that extend
-LAMMPS functionality.
+This section gives an overview of the add-on packages that extend
+LAMMPS functionality. Two tables, for standard and user packages, are
+below. A brief sub-section for each package follows, with a summary
+of what the package contains, how to install it, and pointers to
+examples of its use or documentation provided in the LAMMPS
+distribution.
| 4.1 :ref:`Standard packages `
| 4.2 :ref:`User packages `
@@ -33,12 +37,11 @@ the USER-OMP package is already installed, both the pair
lj/cut/coul/long and lj/cut/coul/long/omp commands will be installed.
The two tables below list currently available packages in LAMMPS, with
-a one-line descriptions of each. The sections below give a few more
-details, including instructions for building LAMMPS with the package,
-either via the make command or the Make.py tool described in :ref:`Section 2.4 `.
-
+a one-line descriptions of each. The sub-sections below give more
+details.
+----------
.. _pkg_1:
@@ -46,76 +49,76 @@ either via the make command or the Make.py tool described in :ref:`Section 2.4 <
Standard packages
-----------------------------
-The current list of standard packages is as follows.
+The current list of standard packages is as follows. Each package
+name links to a sub-section below with more details on how to build
+with the package and pointers to additional info.
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| Package | Description | Author(s) | Doc page | Example | Library |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| ASPHERE | aspherical particles | - | :ref:`Section_howto 6.14 ` | ellipse | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| BODY | body-style particles | - | :doc:`body ` | body | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| CLASS2 | class 2 force fields | - | :doc:`pair_style lj/class2 ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| COLLOID | colloidal particles | - | :doc:`atom_style colloid ` | colloid | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| COMPRESS | I/O compression | Axel Kohlmeyer (Temple U) | :doc:`dump */gz ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| CORESHELL | adiabatic core/shell model | Hendrik Heenen (Technical U of Munich) | :ref:`Section_howto 6.25 ` | coreshell | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| DIPOLE | point dipole particles | - | :doc:`pair_style dipole/cut ` | dipole | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| FLD | Fast Lubrication Dynamics | Kumar & Bybee & Higdon (1) | :doc:`pair_style lubricateU ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| GPU | GPU-enabled styles | Mike Brown (ORNL) | :doc:`Section accelerate ` | gpu | lib/gpu |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| GRANULAR | granular systems | - | :ref:`Section_howto 6.6 ` | pour | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| KIM | openKIM potentials | Smirichinski & Elliot & Tadmor (3) | :doc:`pair_style kim ` | kim | KIM |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| KOKKOS | Kokkos-enabled styles | Trott & Edwards (4) | :doc:`Section_accelerate ` | kokkos | lib/kokkos |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| KSPACE | long-range Coulombic solvers | - | :doc:`kspace_style ` | peptide | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| MANYBODY | many-body potentials | - | :doc:`pair_style tersoff ` | shear | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| MEAM | modified EAM potential | Greg Wagner (Sandia) | :doc:`pair_style meam ` | meam | lib/meam |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| MC | Monte Carlo options | - | :doc:`fix gcmc ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| MOLECULE | molecular system force fields | - | :ref:`Section_howto 6.3 ` | peptide | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| OPT | optimized pair styles | Fischer & Richie & Natoli (2) | :doc:`Section accelerate ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| PERI | Peridynamics models | Mike Parks (Sandia) | :doc:`pair_style peri ` | peri | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| POEMS | coupled rigid body motion | Rudra Mukherjee (JPL) | :doc:`fix poems ` | rigid | lib/poems |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| PYTHON | embed Python code in an input script | - | :doc:`python ` | python | lib/python |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| REAX | ReaxFF potential | Aidan Thompson (Sandia) | :doc:`pair_style reax ` | reax | lib/reax |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| REPLICA | multi-replica methods | - | :ref:`Section_howto 6.5 ` | tad | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| RIGID | rigid bodies | - | :doc:`fix rigid ` | rigid | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| SHOCK | shock loading methods | - | :doc:`fix msst ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| SNAP | quantum-fit potential | Aidan Thompson (Sandia) | :doc:`pair snap ` | snap | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| SRD | stochastic rotation dynamics | - | :doc:`fix srd ` | srd | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| VORONOI | Voronoi tesselations | Daniel Schwen (LANL) | :doc:`compute voronoi/atom ` | - | Voro++ |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| XTC | dumps in XTC format | - | :doc:`dump ` | - | - |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
-| | | | | | |
-+-----------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| Package | Description | Author(s) | Doc page | Example | Library |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`ASPHERE ` | aspherical particles | - | :ref:`Section_howto 6.14 ` | ellipse | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`BODY ` | body-style particles | - | :doc:`body ` | body | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`CLASS2 ` | class 2 force fields | - | :doc:`pair_style lj/class2 ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`COLLOID ` | colloidal particles | - | :doc:`atom_style colloid ` | colloid | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`COMPRESS ` | I/O compression | Axel Kohlmeyer (Temple U) | :doc:`dump */gz ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`CORESHELL ` | adiabatic core/shell model | Hendrik Heenen (Technical U of Munich) | :ref:`Section_howto 6.25 ` | coreshell | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`DIPOLE ` | point dipole particles | - | :doc:`pair_style dipole/cut ` | dipole | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`FLD ` | Fast Lubrication Dynamics | Kumar & Bybee & Higdon (1) | :doc:`pair_style lubricateU ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`GPU ` | GPU-enabled styles | Mike Brown (ORNL) | :doc:`Section accelerate ` | gpu | lib/gpu |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`GRANULAR ` | granular systems | - | :ref:`Section_howto 6.6 ` | pour | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`KIM ` | openKIM potentials | Smirichinski & Elliot & Tadmor (3) | :doc:`pair_style kim ` | kim | KIM |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`KOKKOS ` | Kokkos-enabled styles | Trott & Edwards (4) | :doc:`Section_accelerate ` | kokkos | lib/kokkos |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`KSPACE ` | long-range Coulombic solvers | - | :doc:`kspace_style ` | peptide | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`MANYBODY ` | many-body potentials | - | :doc:`pair_style tersoff ` | shear | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`MEAM ` | modified EAM potential | Greg Wagner (Sandia) | :doc:`pair_style meam ` | meam | lib/meam |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`MC ` | Monte Carlo options | - | :doc:`fix gcmc ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`MOLECULE ` | molecular system force fields | - | :ref:`Section_howto 6.3 ` | peptide | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`OPT ` | optimized pair styles | Fischer & Richie & Natoli (2) | :doc:`Section accelerate ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`PERI ` | Peridynamics models | Mike Parks (Sandia) | :doc:`pair_style peri ` | peri | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`POEMS ` | coupled rigid body motion | Rudra Mukherjee (JPL) | :doc:`fix poems ` | rigid | lib/poems |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`PYTHON ` | embed Python code in an input script | - | :doc:`python ` | python | lib/python |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`REAX ` | ReaxFF potential | Aidan Thompson (Sandia) | :doc:`pair_style reax ` | reax | lib/reax |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`REPLICA ` | multi-replica methods | - | :ref:`Section_howto 6.5 ` | tad | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`RIGID ` | rigid bodies | - | :doc:`fix rigid ` | rigid | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`SHOCK ` | shock loading methods | - | :doc:`fix msst ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`SNAP ` | quantum-fit potential | Aidan Thompson (Sandia) | :doc:`pair snap ` | snap | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`SRD ` | stochastic rotation dynamics | - | :doc:`fix srd ` | srd | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`VORONOI ` | Voronoi tesselations | Daniel Schwen (LANL) | :doc:`compute voronoi/atom ` | - | Voro++ |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| :ref:`XTC ` | dumps in XTC format | - | :doc:`dump ` | - | - |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
+| | | | | | |
++------------------------------+--------------------------------------+----------------------------------------+----------------------------------------------------+-----------+------------+
The "Authors" column lists a name(s) if a specific person is
responible for creating and maintaining the package.
-More details on
-multiple authors are give below.
(1) The FLD package was created by Amit Kumar and Michael Bybee from
Jonathan Higdon's group at UIUC.
@@ -131,9 +134,10 @@ and Ellad Tadmor (U Minn).
(Sandia). It uses the Kokkos library which was developed by Carter
Edwards, Christian, and collaborators at Sandia.
-The "Doc page" column links to either a portion of the
+The "Doc page" column links to either a sub-section of the
:doc:`Section_howto ` of the manual, or an input script
-command implemented as part of the package.
+command implemented as part of the package, or to additional
+documentation provided within the package.
The "Example" column is a sub-directory in the examples directory of
the distribution which has an input script that uses the package.
@@ -145,80 +149,1164 @@ lib/package, then the code for the library is under the lib directory
of the LAMMPS distribution. See the lib/package/README file for info
on how to build the library. If it is not listed as lib/package, then
it is a third-party library not included in the LAMMPS distribution.
-See the src/package/README or src/package/Makefile.lammps file for
-info on where to download the library. :ref:`Section start ` of the manual also gives details
-on how to build LAMMPS with both kinds of auxiliary libraries.
+See details on all of this below for individual packages.
-Except where explained below, all of these packages can be installed,
-and LAMMPS re-built, by issuing these commands from the src dir.
+
+----------
+
+
+.. _ASPHERE:
+
+ASPHERE package
+---------------
+
+Contents: Aspherical particle models for ellipsoids, 2d lines, 3d
+triangles.
+
+To install via make or Make.py:
.. parsed-literal::
- make yes-package
+ make yes-asphere
make machine
- or
- Make.py -p package -a machine
-
-To un-install the package and re-build LAMMPS without it:
.. parsed-literal::
- make no-package
+ Make.py -p asphere -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-asphere
make machine
- or
- Make.py -p ^package -a machine
-"Package" is the name of the package in lower-case letters,
-e.g. asphere or rigid, and "machine" is the build target, e.g. mpi or
-serial.
+.. parsed-literal::
+
+ Make.py -p ^asphere -a machine
+
+Supporting info: examples/ASPHERE, examples/ellipse, Section howto
+6.14, pair gayberne
+----------
+.. _BODY:
-Build instructions for COMPRESS package
------------------------------
+BODY package
+------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Supporting info: examples/body
-Build instructions for GPU package
-------------------------
+----------
-Build instructions for KIM package
-------------------------
+.. _CLASS2:
+
+CLASS2 package
+--------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-class2
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p class2 -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-class2
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^class2 -a machine
+
+Supporting info:
-Build instructions for KOKKOS package
----------------------------
+----------
-Build instructions for KSPACE package
----------------------------
+.. _COLLOID:
+
+COLLOID package
+---------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-colloid
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p colloid -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-colloid
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^colloid -a machine
+
+Supporting info: examples/colloid, examples/srd
-Build instructions for MEAM package
--------------------------
+----------
-Build instructions for POEMS package
---------------------------
+.. _COMPRESS:
+
+COMPRESS package
+----------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-compress
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p compress -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-compress
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^compress -a machine
+
+Supporting info:
-Build instructions for PYTHON package
----------------------------
+----------
-Build instructions for REAX package
--------------------------
+.. _CORESHELL:
+
+CORESHELL package
+-----------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-coreshell
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p coreshell -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-coreshell
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^coreshell -a machine
+
+Supporting info: examples/coreshell, Section howto 6.26
-Build instructions for VORONOI package
-----------------------------
+----------
-Build instructions for XTC package
-------------------------
+.. _DIPOLE:
+DIPOLE package
+--------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-dipole
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p dipole -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-dipole
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^dipole -a machine
+
+Supporting info: examples/dipole
+
+
+----------
+
+
+.. _FLD:
+
+FLD package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-fld
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p fld -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-fld
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^fld -a machine
+
+Supporting info:
+
+
+----------
+
+
+.. _GPU:
+
+GPU package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-gpu
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p gpu -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-gpu
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^gpu -a machine
+
+Supporting info: examples/accelerate, bench/FERMI, bench/KEPLER
+
+
+----------
+
+
+.. _GRANULAR:
+
+GRANULAR package
+----------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-granular
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p granular -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-granular
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^granular -a machine
+
+Supporting info: examples/pour, bench/in.chute, Section howto 6.6
+
+
+----------
+
+
+.. _KIM:
+
+KIM package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-kim
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p kim -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-kim
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^kim -a machine
+
+Supporting info: examples/kim
+
+
+----------
+
+
+.. _KOKKOS:
+
+KOKKOS package
+--------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-kokkow
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p kokkow -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-kokkow
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^kokkow -a machine
+
+Supporting info:
+
+For the KOKKOS package, you have 3 choices when building. You can
+build with OMP or Cuda or Phi support. Phi support uses Xeon Phi
+chips in "native" mode. This can be done by setting the following
+variables in your Makefile.machine:
+
+* for OMP support, set OMP = yes
+* for Cuda support, set OMP = yes and CUDA = yes
+* for Phi support, set OMP = yes and MIC = yes
+
+These can also be set as additional arguments to the make command, e.g.
+
+.. parsed-literal::
+
+ make g++ OMP=yes MIC=yes
+
+Building the KOKKOS package with CUDA support requires a Makefile
+machine that uses the NVIDIA "nvcc" compiler, as well as an
+appropriate "arch" setting appropriate to the GPU hardware and NVIDIA
+software you have on your machine. See
+src/MAKE/OPTIONS/Makefile.kokkos_cuda for an example of such a machine
+Makefile.
+
+Examples: examples/accelerate, bench/FERMI, bench/KEPLER
+
+
+----------
+
+
+.. _KSPACE:
+
+KSPACE package
+--------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-kspace
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p kspace -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-kspace
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^kspace -a machine
+
+Supporting info:
+
+Examples: examples/peptide, bench/in.rhodo
+
+Doc: Section howto 6.7, Section howto 6.8, Section howto 6.9
+
+
+----------
+
+
+.. _MANYBODY:
+
+MANYBODY package
+----------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-manybody
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p manybody -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-manybody
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^manybody -a machine
+
+Supporting info:
+
+Examples: examples/comb, examples/eim, examples/nb3d, examples/vashishta
+
+
+----------
+
+
+.. _MC:
+
+MC package
+----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-mc
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p mc -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-mc
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^mc -a machine
+
+Supporting info:
+
+
+----------
+
+
+.. _MEAM:
+
+MEAM package
+------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-meam
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p meam -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-meam
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^meam -a machine
+
+Supporting info: examples/meam
+
+
+----------
+
+
+.. _MISC:
+
+MISC package
+------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-misc
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p misc -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-misc
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^misc -a machine
+
+Supporting info: examples/misc
+
+
+----------
+
+
+.. _MOLECULE:
+
+MOLECULE package
+----------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-molecule
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p molecule -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-molecule
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^molecule -a machine
+
+Supporting info: examples/micelle, examples/peptide, bench/in.chain, bench/in.rhodo, Section howto 6.3
+
+
+----------
+
+
+.. _MPIIO:
+
+MPIIO package
+-------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-mpiio
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p mpiio -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-mpiio
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^mpiio -a machine
+
+Supporting info:
+
+
+----------
+
+
+.. _OPT:
+
+OPT package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-opt
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p opt -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-opt
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^opt -a machine
+
+Supporting info: examples/accelerate, bench/KEPLER
+
+For the OPT package, your Makefile.machine needs an additional
+settings for CCFLAGS.
+
+* CCFLAGS: add -restrict
+
+
+----------
+
+
+.. _PERI:
+
+PERI package
+------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-peri
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p peri -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-peri
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^peri -a machine
+
+Supporting info: examples/peri
+
+
+----------
+
+
+.. _POEMS:
+
+POEMS package
+-------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-poems
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p poems -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-poems
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^poems -a machine
+
+Supporting info: examples/rigid
+
+
+----------
+
+
+.. _PYTHON:
+
+PYTHON package
+--------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-python
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p python -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-python
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^python -a machine
+
+Supporting info: examples/python
+
+
+----------
+
+
+.. _QEQ:
+
+QEQ package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-qeq
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p qeq -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-qeq
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^qeq -a machine
+
+Supporting info: examples/qeq
+
+
+----------
+
+
+.. _REAX:
+
+REAX package
+------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-reax
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p reax -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-reax
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^reax -a machine
+
+Supporting info: examples/reax
+
+
+----------
+
+
+.. _REPLICA:
+
+REPLICA package
+---------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-replica
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p replica -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-replica
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^replica -a machine
+
+Supporting info: examples/neb, examples/prd, examples/tad, Section howto 6.5
+
+
+----------
+
+
+.. _RIGID:
+
+RIGID package
+-------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-rigid
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p rigid -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-rigid
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^rigid -a machine
+
+Supporting info: examples/ASPHERE, examples/rigid
+
+
+----------
+
+
+.. _SHOCK:
+
+SHOCK package
+-------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-shock
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p shock -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-shock
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^shock -a machine
+
+Supporting info: examples/hugoniostat, examples/msst
+
+
+----------
+
+
+.. _SNAP:
+
+SNAP package
+------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-snap
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p snap -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-snap
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^snap -a machine
+
+Supporting info: examples/snap
+
+
+----------
+
+
+.. _SRD:
+
+SRD package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-srd
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p srd -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-srd
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^srd -a machine
+
+Supporting info:
+
+
+----------
+
+
+.. _VORONOI:
+
+VORONOI package
+---------------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-voronoi
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p voronoi -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-voronoi
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^voronoi -a machine
+
+Supporting info: examples/voronoi
+
+
+----------
+
+
+.. _XTC:
+
+XTC package
+-----------
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-xtc
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p xtc -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-xtc
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^xtc -a machine
+
+Supporting info:
----------
@@ -231,63 +1319,65 @@ User packages
The current list of user-contributed packages is as follows:
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| Package | Description | Author(s) | Doc page | Example | Pic/movie | Library |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-ATC | atom-to-continuum coupling | Jones & Templeton & Zimmerman (1) | :doc:`fix atc ` | USER/atc | `atc `_ | lib/atc |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-AWPMD | wave-packet MD | Ilya Valuev (JIHT) | :doc:`pair_style awpmd/cut ` | USER/awpmd | - | lib/awpmd |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-CG-CMM | coarse-graining model | Axel Kohlmeyer (Temple U) | :doc:`pair_style lj/sdk ` | USER/cg-cmm | `cg `_ | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-COLVARS | collective variables | Fiorin & Henin & Kohlmeyer (2) | :doc:`fix colvars ` | USER/colvars | `colvars `_ | lib/colvars |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-CUDA | NVIDIA GPU styles | Christian Trott (U Tech Ilmenau) | :doc:`Section accelerate ` | USER/cuda | - | lib/cuda |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-DIFFRACTION | virutal x-ray and electron diffraction | Shawn Coleman (ARL) | :doc:`compute xrd ` | USER/diffraction | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-DPD | dissipative particle dynamics (DPD) | Larentzos & Mattox & Brennan (5) | src/USER-DPD/README | USER/dpd | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-DRUDE | Drude oscillators | Dequidt & Devemy & Padua (3) | :doc:`tutorial ` | USER/drude | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-EFF | electron force field | Andres Jaramillo-Botero (Caltech) | :doc:`pair_style eff/cut ` | USER/eff | `eff `_ | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-FEP | free energy perturbation | Agilio Padua (U Blaise Pascal Clermont-Ferrand) | :doc:`compute fep ` | USER/fep | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-H5MD | dump output via HDF5 | Pierre de Buyl (KU Leuven) | :doc:`dump h5md ` | - | - | lib/h5md |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-INTEL | Vectorized CPU and Intel(R) coprocessor styles | W. Michael Brown (Intel) | :doc:`Section accelerate ` | examples/intel | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-LB | Lattice Boltzmann fluid | Colin Denniston (U Western Ontario) | :doc:`fix lb/fluid ` | USER/lb | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-MGPT | fast MGPT multi-ion potentials | Tomas Oppelstrup & John Moriarty (LLNL) | :doc:`pair_style mgpt ` | USER/mgpt | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-MISC | single-file contributions | USER-MISC/README | USER-MISC/README | - | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-MOLFILE | `VMD `_ molfile plug-ins | Axel Kohlmeyer (Temple U) | :doc:`dump molfile ` | - | - | VMD-MOLFILE |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-OMP | OpenMP threaded styles | Axel Kohlmeyer (Temple U) | :doc:`Section accelerate ` | - | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-PHONON | phonon dynamical matrix | Ling-Ti Kong (Shanghai Jiao Tong U) | :doc:`fix phonon ` | USER/phonon | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-QMMM | QM/MM coupling | Axel Kohlmeyer (Temple U) | :doc:`fix qmmm ` | USER/qmmm | - | lib/qmmm |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-QTB | quantum nuclear effects | Yuan Shen (Stanford) | :doc:`fix qtb ` :doc:`fix_qbmsst ` | qtb | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-QUIP | QUIP/libatoms interface | Albert Bartok-Partay (U Cambridge) | :doc:`pair_style quip ` | USER/quip | - | lib/quip |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-REAXC | C version of ReaxFF | Metin Aktulga (LBNL) | :doc:`pair_style reaxc ` | reax | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-SMD | smoothed Mach dynamics | Georg Ganzenmuller (EMI) | `userguide.pdf `_ | USER/smd | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-SMTBQ | Second Moment Tight Binding - QEq potential | Salles & Maras & Politano & Tetot (4) | :doc:`pair_style smtbq ` | USER/smtbq | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-SPH | smoothed particle hydrodynamics | Georg Ganzenmuller (EMI) | `userguide.pdf `_ | USER/sph | `sph `_ | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| USER-TALLY | Pairwise tallied computes | Axel Kohlmeyer (Temple U) | :doc:`compute <...>/tally ` | USER/tally | - | - |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
-| | | | | | | |
-+------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| Package | Description | Author(s) | Doc page | Example | Pic/movie | Library |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-ATC ` | atom-to-continuum coupling | Jones & Templeton & Zimmerman (1) | :doc:`fix atc ` | USER/atc | `atc `_ | lib/atc |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-AWPMD ` | wave-packet MD | Ilya Valuev (JIHT) | :doc:`pair_style awpmd/cut ` | USER/awpmd | - | lib/awpmd |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-CG-CMM ` | coarse-graining model | Axel Kohlmeyer (Temple U) | :doc:`pair_style lj/sdk ` | USER/cg-cmm | `cg `_ | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-COLVARS ` | collective variables | Fiorin & Henin & Kohlmeyer (2) | :doc:`fix colvars ` | USER/colvars | `colvars `_ | lib/colvars |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-CUDA ` | NVIDIA GPU styles | Christian Trott (U Tech Ilmenau) | :doc:`Section accelerate ` | USER/cuda | - | lib/cuda |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-DIFFRACTION ` | virutal x-ray and electron diffraction | Shawn Coleman (ARL) | :doc:`compute xrd ` | USER/diffraction | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-DPD ` | dissipative particle dynamics (DPD) | Larentzos & Mattox & Brennan (5) | src/USER-DPD/README | USER/dpd | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-DRUDE ` | Drude oscillators | Dequidt & Devemy & Padua (3) | :doc:`tutorial ` | USER/drude | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-EFF ` | electron force field | Andres Jaramillo-Botero (Caltech) | :doc:`pair_style eff/cut ` | USER/eff | `eff `_ | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-FEP ` | free energy perturbation | Agilio Padua (U Blaise Pascal Clermont-Ferrand) | :doc:`compute fep ` | USER/fep | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-H5MD ` | dump output via HDF5 | Pierre de Buyl (KU Leuven) | :doc:`dump h5md ` | - | - | lib/h5md |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-INTEL ` | Vectorized CPU and Intel(R) coprocessor styles | W. Michael Brown (Intel) | :doc:`Section accelerate ` | examples/intel | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-LB ` | Lattice Boltzmann fluid | Colin Denniston (U Western Ontario) | :doc:`fix lb/fluid ` | USER/lb | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-MGPT ` | fast MGPT multi-ion potentials | Tomas Oppelstrup & John Moriarty (LLNL) | :doc:`pair_style mgpt ` | USER/mgpt | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-MISC ` | single-file contributions | USER-MISC/README | USER-MISC/README | - | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-MOLFILE ` | `VMD `_ molfile plug-ins | Axel Kohlmeyer (Temple U) | :doc:`dump molfile ` | - | - | VMD-MOLFILE |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-OMP ` | OpenMP threaded styles | Axel Kohlmeyer (Temple U) | :doc:`Section accelerate ` | - | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-PHONON ` | phonon dynamical matrix | Ling-Ti Kong (Shanghai Jiao Tong U) | :doc:`fix phonon ` | USER/phonon | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-QMMM ` | QM/MM coupling | Axel Kohlmeyer (Temple U) | :doc:`fix qmmm ` | USER/qmmm | - | lib/qmmm |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-QTB ` | quantum nuclear effects | Yuan Shen (Stanford) | :doc:`fix qtb ` :doc:`fix_qbmsst ` | qtb | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-QUIP ` | QUIP/libatoms interface | Albert Bartok-Partay (U Cambridge) | :doc:`pair_style quip ` | USER/quip | - | lib/quip |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-REAXC ` | C version of ReaxFF | Metin Aktulga (LBNL) | :doc:`pair_style reaxc ` | reax | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-SMD ` | smoothed Mach dynamics | Georg Ganzenmuller (EMI) | `userguide.pdf `_ | USER/smd | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-SMTBQ ` | Second Moment Tight Binding - QEq potential | Salles & Maras & Politano & Tetot (4) | :doc:`pair_style smtbq ` | USER/smtbq | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-SPH ` | smoothed particle hydrodynamics | Georg Ganzenmuller (EMI) | `userguide.pdf `_ | USER/sph | `sph `_ | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-TALLY ` | Pairwise tallied computes | Axel Kohlmeyer (Temple U) | :doc:`compute <...>/tally ` | USER/tally | - | - |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| :ref:`USER-VTK ` | VTK-style dumps | Berger and Queteschiner (6) | :doc:`compute custom/vtk ` | - | - | lib/vtk |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
+| | | | | | | |
++--------------------------------------------+------------------------------------------------+-------------------------------------------------+---------------------------------------------------------+------------------+----------------------+-------------+
.. _atc: http://lammps.sandia.gov/pictures.html#atc
@@ -326,15 +1416,13 @@ Clermont-Ferrand) and co-authors Julien Devemy (CNRS) and Agilio Padua
(4) The SMTBQ package was created by Nicolas Salles, Emile Maras,
Olivier Politano, and Robert Tetot (LAAS-CNRS, France).
-(4) The USER-DPD package was created by James Larentzos, Timothy
-Mattox, and John Brennan (Army Research Lab (ARL) and Engility Corp).
+(5) The USER-DPD package was created by James Larentzos (ARL), Timothy
+Mattox (Engility), and John Brennan (ARL).
-If the Library is not listed as lib/package, then it is a third-party
-library not included in the LAMMPS distribution. See the
-src/package/Makefile.lammps file for info on where to download the
-library from.
+(6) The USER-VTK package was created by Richard Berger (JKU) and
+Daniel Queteschiner (DCS Computing).
-The "Doc page" column links to either a portion of the
+The "Doc page" column links to either a sub-section of the
:doc:`Section_howto ` of the manual, or an input script
command implemented as part of the package, or to additional
documentation provided within the package.
@@ -350,41 +1438,25 @@ lib/package, then the code for the library is under the lib directory
of the LAMMPS distribution. See the lib/package/README file for info
on how to build the library. If it is not listed as lib/package, then
it is a third-party library not included in the LAMMPS distribution.
-See the src/package/Makefile.lammps file for info on where to download
-the library. :ref:`Section start ` of the
-manual also gives details on how to build LAMMPS with both kinds of
-auxiliary libraries.
-
-Except where explained below, all of these packages can be installed,
-and LAMMPS re-built, by issuing these commands from the src dir.
-
-.. parsed-literal::
-
- make yes-user-package
- make machine
- or
- Make.py -p package -a machine
-
-To un-install the package and re-build LAMMPS without it:
-
-.. parsed-literal::
-
- make no-user-package
- make machine
- or
- Make.py -p ^package -a machine
-
-"Package" is the name of the package (in this case without the user
-prefix) in lower-case letters, e.g. drude or phonon, and "machine" is
-the build target, e.g. mpi or serial.
+See details on all of this below for individual packages.
+----------
+.. _USER-ATC:
USER-ATC package
----------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements a "fix atc" command which can be used in a
LAMMPS input script. This fix can be employed to either do concurrent
coupling of MD with FE-based physics surrogates or on-the-fly
@@ -406,13 +1478,25 @@ sandia.gov), Jeremy Templeton (jatempl at sandia.gov) and Jon
Zimmerman (jzimmer at sandia.gov) at Sandia. Contact them directly if
you have questions.
+Examples: examples/USER/atc
+
----------
+.. _USER-AWPMD:
+
USER-AWPMD package
------------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a LAMMPS implementation of the Antisymmetrized
Wave Packet Molecular Dynamics (AWPMD) method.
@@ -429,13 +1513,43 @@ The person who created this package is Ilya Valuev at the JIHT in
Russia (valuev at physik.hu-berlin.de). Contact him directly if you
have questions.
+Examples: examples/USER/awpmd
+
----------
+.. _USER-CG-CMM:
+
USER-CG-CMM package
-------------------
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Supporting info:
+
This package implements 3 commands which can be used in a LAMMPS input
script:
@@ -473,13 +1587,25 @@ simulation systems.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
+Examples: examples/USER/cg-cmm
+
----------
+.. _USER-COLVARS:
+
USER-COLVARS package
--------------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements the "fix colvars" command which can be
used in a LAMMPS input script.
@@ -510,10 +1636,22 @@ beta quality.
The person who created this package is Axel Kohlmeyer at Temple U
(akohlmey at gmail.com). Contact him directly if you have questions.
+Examples: examples/USER/colvars
+
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
----------
+.. _USER-CUDA:
+
USER-CUDA package
-----------------
@@ -537,10 +1675,22 @@ The person who created this package is Christian Trott at the
University of Technology Ilmenau, Germany (christian.trott at
tu-ilmenau.de). Contact him directly if you have questions.
+Examples: examples/accelerate, bench/FERMI, bench/KEPLER
+
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
----------
+.. _USER-DIFFRACTION:
+
USER-DIFFRACTION package
------------------------
@@ -558,10 +1708,40 @@ The person who created this package is Shawn P. Coleman
(shawn.p.coleman8.ctr at mail.mil) while at the University of
Arkansas. Contact him directly if you have questions.
+Examples: examples/USER/diffraction
+
+Contents:
+
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Supporting info:
+
----------
+.. _USER-DPD:
+
USER-DPD package
----------------
@@ -588,13 +1768,47 @@ The people who created this package are James Larentzos
engilitycorp.com) and John Brennan (john.k.brennan.civ at mail.mil).
Contact them directly if you have questions.
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Examples: examples/USER/dpd
+
----------
+.. _USER-DRUDE:
+
USER-DRUDE package
------------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package implements methods for simulating polarizable systems
in LAMMPS using thermalized Drude oscillators.
@@ -614,13 +1828,49 @@ Blaise Pascal Clermont-Ferrand (alain.dequidt at univ-bpclermont.fr)
Contact him directly if you have questions. Co-authors: Julien Devemy,
Agilio Padua.
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Examples: examples/USER/drude
+
+Doc: Section howto 6.27
+
----------
+.. _USER-EFF:
+
USER-EFF package
----------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a LAMMPS implementation of the electron Force
Field (eFF) currently under development at Caltech, as described in
A. Jaramillo-Botero, J. Su, Q. An, and W.A. Goddard III, JCC,
@@ -658,13 +1908,47 @@ The person who created this package is Andres Jaramillo-Botero at
CalTech (ajaramil at wag.caltech.edu). Contact him directly if you
have questions.
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Examples: examples/USER/eff
+
----------
+.. _USER-FEP:
+
USER-FEP package
----------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package provides methods for performing free energy perturbation
simulations with soft-core pair potentials in LAMMPS.
@@ -678,13 +1962,47 @@ The person who created this package is Agilio Padua at Universite
Blaise Pascal Clermont-Ferrand (agilio.padua at univ-bpclermont.fr)
Contact him directly if you have questions.
+To install via make or Make.py:
+
+.. parsed-literal::
+
+ make yes-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p body -a machine
+
+To un-install via make or Make.py:
+
+.. parsed-literal::
+
+ make no-body
+ make machine
+
+.. parsed-literal::
+
+ Make.py -p ^body -a machine
+
+Examples: examples/USER/fep
+
----------
+.. _USER-H5MD:
+
USER-H5MD package
-----------------
+Contents:
+
+To install via make or Make.py:
+
+To un-install via make or Make.py:
+
+Supporting info:
+
This package contains a :doc:`dump h5md | | | | | | | | | | | | | | | |