LAMMPS Users Manual24 Jan 2013 version

http://lammps.sandia.gov - Sandia National LaboratoriesCopyright (2003) Sandia Corporation. This software and manual is distributed under the GNU General Public License.

Table of ContentsLAMMPS Documentation.............................................................................................................................1

7 Jun 2013 version...................................................................................................................................1Version info:.....................................................................................................................................1

1. Introduction.........................................................................................................................................41.1 What is LAMMPS......................................................................................................................41.2 LAMMPS features......................................................................................................................5General features................................................................................................................................5Particle and model types...................................................................................................................5Force fields........................................................................................................................................5Atom creation....................................................................................................................................6Ensembles, constraints, and boundary conditions............................................................................6Integrators.........................................................................................................................................7Diagnostics........................................................................................................................................7Output...............................................................................................................................................7Multi-replica models.........................................................................................................................7Pre- and post-processing...................................................................................................................7Specialized features..........................................................................................................................71.3 LAMMPS non-features...............................................................................................................81.4 Open source distribution.............................................................................................................91.5 Acknowledgments and citations...............................................................................................10

2. Getting Started...................................................................................................................................122.1 What's in the LAMMPS distribution........................................................................................122.2 Making LAMMPS....................................................................................................................132.3 Making LAMMPS with optional packages..............................................................................192.4 Building LAMMPS via the Make.py script..............................................................................212.5 Building LAMMPS as a library................................................................................................222.6 Running LAMMPS...................................................................................................................242.7 Command-line options..............................................................................................................252.8 LAMMPS screen output...........................................................................................................292.9 Tips for users of previous LAMMPS versions.........................................................................30

3. Commands.........................................................................................................................................323.1 LAMMPS input script...............................................................................................................323.2 Parsing rules..............................................................................................................................333.3 Input script structure.................................................................................................................343.4 Commands listed by category...................................................................................................353.5 Individual commands................................................................................................................36Fix styles.........................................................................................................................................37Compute styles................................................................................................................................37Pair_style potentials........................................................................................................................38Bond_style potentials......................................................................................................................39Angle_style potentials.....................................................................................................................40Dihedral_style potentials................................................................................................................40Improper_style potentials................................................................................................................41Kspace solvers................................................................................................................................41

4. Packages............................................................................................................................................424.1 Standard packages.....................................................................................................................424.2 User packages...........................................................................................................................43USER-MISC package.....................................................................................................................44

LAMMPS Users Manual

i

Table of ContentsUSER-ATC package.......................................................................................................................45USER-AWPMD package................................................................................................................45USER-COLVARS package............................................................................................................45USER-CG-CMM package..............................................................................................................46USER-CUDA package....................................................................................................................46USER-EFF package........................................................................................................................47USER-OMP package......................................................................................................................47USER-REAXC package.................................................................................................................47USER-SPH package........................................................................................................................48

5. Accelerating LAMMPS performance................................................................................................495.1 Measuring performance............................................................................................................495.2 General strategies......................................................................................................................505.3 Packages with optimized styles................................................................................................505.4 OPT package.............................................................................................................................515.5 USER-OMP package................................................................................................................515.6 GPU package............................................................................................................................535.7 USER-CUDA package..............................................................................................................555.8 Comparison of GPU and USER-CUDA packages...................................................................57

6. How-to discussions............................................................................................................................596.1 Restarting a simulation.............................................................................................................596.2 2d simulations...........................................................................................................................616.3 CHARMM, AMBER, and DREIDING force fields...........................