2007-09-28 07:25:52 +08:00
|
|
|
<HEAD>
|
|
|
|
|
<TITLE>LAMMPS Users Manual</TITLE>
|
2013-01-25 23:23:38 +08:00
|
|
|
<META NAME="docnumber" CONTENT="24 Jan 2013 version">
|
2007-09-28 07:25:52 +08:00
|
|
|
<META NAME="author" CONTENT="http://lammps.sandia.gov - Sandia National Laboratories">
|
|
|
|
|
<META NAME="copyright" CONTENT="Copyright (2003) Sandia Corporation. This software and manual is distributed under the GNU General Public License.">
|
|
|
|
|
</HEAD>
|
|
|
|
|
|
|
|
|
|
<BODY>
|
|
|
|
|
|
2006-09-22 00:22:34 +08:00
|
|
|
"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
|
|
|
|
|
|
|
|
|
|
:link(lws,http://lammps.sandia.gov)
|
|
|
|
|
:link(ld,Manual.html)
|
|
|
|
|
:link(lc,Section_commands.html#comm)
|
|
|
|
|
|
|
|
|
|
:line
|
|
|
|
|
|
|
|
|
|
<H1></H1>
|
|
|
|
|
|
|
|
|
|
LAMMPS Documentation :c,h3
|
2013-01-26 00:37:28 +08:00
|
|
|
25 Jan 2013 version :c,h4
|
2006-09-22 00:22:34 +08:00
|
|
|
|
2011-02-08 07:59:23 +08:00
|
|
|
Version info: :h4
|
2010-09-07 04:22:15 +08:00
|
|
|
|
2011-02-08 07:54:38 +08:00
|
|
|
The LAMMPS "version" is the date when it was released, such as 1 May
|
|
|
|
|
2010. LAMMPS is updated continuously. Whenever we fix a bug or add a
|
|
|
|
|
feature, we release it immediately, and post a notice on "this page of
|
|
|
|
|
the WWW site"_bug. Each dated copy of LAMMPS contains all the
|
|
|
|
|
features and bug-fixes up to and including that version date. The
|
|
|
|
|
version date is printed to the screen and logfile every time you run
|
|
|
|
|
LAMMPS. It is also in the file src/version.h and in the LAMMPS
|
2013-01-25 23:05:22 +08:00
|
|
|
directory name created when you unpack a tarball, and at the top of
|
|
|
|
|
the first page of the manual (this page).
|
2011-02-08 07:54:38 +08:00
|
|
|
|
|
|
|
|
If you browse the HTML doc pages on the LAMMPS WWW site, they always
|
|
|
|
|
describe the most current version of LAMMPS. :ulb,l
|
|
|
|
|
|
|
|
|
|
If you browse the HTML doc pages included in your tarball, they
|
|
|
|
|
describe the version you have. :l
|
|
|
|
|
|
|
|
|
|
The "PDF file"_Manual.pdf on the WWW site or in the tarball is updated
|
2011-05-28 07:59:19 +08:00
|
|
|
about once per month. This is because it is large, and we don't want
|
2012-06-02 00:41:20 +08:00
|
|
|
it to be part of every patch. :l
|
2011-08-24 07:10:45 +08:00
|
|
|
|
2011-08-26 01:01:01 +08:00
|
|
|
There is also a "Developer.pdf"_Developer.pdf file in the doc
|
2011-08-24 07:11:14 +08:00
|
|
|
directory, which describes the internal structure and algorithms of
|
|
|
|
|
LAMMPS. :ule,l
|
2006-09-22 00:22:34 +08:00
|
|
|
|
|
|
|
|
LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel
|
|
|
|
|
Simulator.
|
|
|
|
|
|
|
|
|
|
LAMMPS is a classical molecular dynamics simulation code designed to
|
|
|
|
|
run efficiently on parallel computers. It was developed at Sandia
|
|
|
|
|
National Laboratories, a US Department of Energy facility, with
|
|
|
|
|
funding from the DOE. It is an open-source code, distributed freely
|
|
|
|
|
under the terms of the GNU Public License (GPL).
|
|
|
|
|
|
2011-02-08 07:54:38 +08:00
|
|
|
The primary developers of LAMMPS are "Steve Plimpton"_sjp, Aidan
|
|
|
|
|
Thompson, and Paul Crozier who can be contacted at
|
|
|
|
|
sjplimp,athomps,pscrozi at sandia.gov. The "LAMMPS WWW Site"_lws at
|
2010-01-15 07:50:34 +08:00
|
|
|
http://lammps.sandia.gov has more information about the code and its
|
|
|
|
|
uses.
|
2006-09-22 00:22:34 +08:00
|
|
|
|
2010-09-07 04:22:15 +08:00
|
|
|
:link(bug,http://lammps.sandia.gov/bug.html)
|
2010-05-07 23:11:21 +08:00
|
|
|
:link(sjp,http://www.sandia.gov/~sjplimp)
|
2006-09-22 00:22:34 +08:00
|
|
|
|
|
|
|
|
:line
|
|
|
|
|
|
|
|
|
|
The LAMMPS documentation is organized into the following sections. If
|
|
|
|
|
you find errors or omissions in this manual or have suggestions for
|
2006-09-26 23:30:56 +08:00
|
|
|
useful information to add, please send an email to the developers so
|
|
|
|
|
we can improve the LAMMPS documentation.
|
2006-09-22 00:22:34 +08:00
|
|
|
|
2007-06-26 08:03:39 +08:00
|
|
|
Once you are familiar with LAMMPS, you may want to bookmark "this
|
|
|
|
|
page"_Section_commands.html#comm at Section_commands.html#comm since
|
|
|
|
|
it gives quick access to documentation for all LAMMPS commands.
|
|
|
|
|
|
2006-09-22 00:22:34 +08:00
|
|
|
"PDF file"_Manual.pdf of the entire manual, generated by
|
|
|
|
|
"htmldoc"_http://www.easysw.com/htmldoc
|
|
|
|
|
|
|
|
|
|
"Introduction"_Section_intro.html :olb,l
|
2011-08-26 00:46:23 +08:00
|
|
|
1.1 "What is LAMMPS"_intro_1 :ulb,b
|
|
|
|
|
1.2 "LAMMPS features"_intro_2 :b
|
|
|
|
|
1.3 "LAMMPS non-features"_intro_3 :b
|
|
|
|
|
1.4 "Open source distribution"_intro_4 :b
|
|
|
|
|
1.5 "Acknowledgments and citations"_intro_5 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
"Getting started"_Section_start.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
2.1 "What's in the LAMMPS distribution"_start_1 :ulb,b
|
|
|
|
|
2.2 "Making LAMMPS"_start_2 :b
|
|
|
|
|
2.3 "Making LAMMPS with optional packages"_start_3 :b
|
2012-01-28 07:39:14 +08:00
|
|
|
2.4 "Building LAMMPS via the Make.py script"_start_4 :b
|
|
|
|
|
2.5 "Building LAMMPS as a library"_start_5 :b
|
|
|
|
|
2.6 "Running LAMMPS"_start_6 :b
|
|
|
|
|
2.7 "Command-line options"_start_7 :b
|
|
|
|
|
2.8 "Screen output"_start_8 :b
|
|
|
|
|
2.9 "Tips for users of previous versions"_start_9 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
"Commands"_Section_commands.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
3.1 "LAMMPS input script"_cmd_1 :ulb,b
|
|
|
|
|
3.2 "Parsing rules"_cmd_2 :b
|
|
|
|
|
3.3 "Input script structure"_cmd_3 :b
|
|
|
|
|
3.4 "Commands listed by category"_cmd_4 :b
|
|
|
|
|
3.5 "Commands listed alphabetically"_cmd_5 :ule,b
|
2011-08-26 00:17:31 +08:00
|
|
|
"Packages"_Section_packages.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
4.1 "Standard packages"_pkg_1 :ulb,b
|
|
|
|
|
4.2 "User packages"_pkg_2 :ule,b
|
2011-12-09 08:45:07 +08:00
|
|
|
"Accelerating LAMMPS performance"_Section_accelerate.html :l
|
2012-08-07 06:50:52 +08:00
|
|
|
5.1 "Measuring performance"_acc_1 :ulb,b
|
|
|
|
|
5.2 "General strategies"_acc_2 :b
|
|
|
|
|
5.3 "Packages with optimized styles"_acc_3 :b
|
|
|
|
|
5.4 "OPT package"_acc_4 :b
|
|
|
|
|
5.5 "USER-OMP package"_acc_5 :b
|
|
|
|
|
5.6 "GPU package"_acc_6 :b
|
|
|
|
|
5.7 "USER-CUDA package"_acc_7 :b
|
|
|
|
|
5.8 "Comparison of GPU and USER-CUDA packages"_acc_8 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
"How-to discussions"_Section_howto.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
6.1 "Restarting a simulation"_howto_1 :ulb,b
|
|
|
|
|
6.2 "2d simulations"_howto_2 :b
|
|
|
|
|
6.3 "CHARMM and AMBER force fields"_howto_3 :b
|
|
|
|
|
6.4 "Running multiple simulations from one input script"_howto_4 :b
|
|
|
|
|
6.5 "Multi-replica simulations"_howto_5 :b
|
|
|
|
|
6.6 "Granular models"_howto_6 :b
|
|
|
|
|
6.7 "TIP3P water model"_howto_7 :b
|
|
|
|
|
6.8 "TIP4P water model"_howto_8 :b
|
|
|
|
|
6.9 "SPC water model"_howto_9 :b
|
|
|
|
|
6.10 "Coupling LAMMPS to other codes"_howto_10 :b
|
|
|
|
|
6.11 "Visualizing LAMMPS snapshots"_howto_11 :b
|
|
|
|
|
6.12 "Triclinic (non-orthogonal) simulation boxes"_howto_12 :b
|
|
|
|
|
6.13 "NEMD simulations"_howto_13 :b
|
|
|
|
|
6.14 "Extended spherical and aspherical particles"_howto_14 :b
|
|
|
|
|
6.15 "Output from LAMMPS (thermo, dumps, computes, fixes, variables)"_howto_15 :b
|
|
|
|
|
6.16 "Thermostatting, barostatting, and compute temperature"_howto_16 :b
|
|
|
|
|
6.17 "Walls"_howto_17 :b
|
|
|
|
|
6.18 "Elastic constants"_howto_18 :b
|
|
|
|
|
6.19 "Library interface to LAMMPS"_howto_19 :b
|
|
|
|
|
6.20 "Calculating thermal conductivity"_howto_20 :b
|
|
|
|
|
6.21 "Calculating viscosity"_howto_21 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
"Example problems"_Section_example.html :l
|
|
|
|
|
"Performance & scalability"_Section_perf.html :l
|
|
|
|
|
"Additional tools"_Section_tools.html :l
|
2011-05-27 07:45:23 +08:00
|
|
|
"Modifying & extending LAMMPS"_Section_modify.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
10.1 "Atom styles"_mod_1 :ulb,b
|
|
|
|
|
10.2 "Bond, angle, dihedral, improper potentials"_mod_2 :b
|
|
|
|
|
10.3 "Compute styles"_mod_3 :b
|
|
|
|
|
10.4 "Dump styles"_mod_4 :b
|
|
|
|
|
10.5 "Dump custom output options"_mod_5 :b
|
|
|
|
|
10.6 "Fix styles"_mod_6 :b
|
|
|
|
|
10.7 "Input script commands"_mod_7 :b
|
|
|
|
|
10.8 "Kspace computations"_mod_8 :b
|
|
|
|
|
10.9 "Minimization styles"_mod_9 :b
|
|
|
|
|
10.10 "Pairwise potentials"_mod_10 :b
|
|
|
|
|
10.11 "Region styles"_mod_11 :b
|
|
|
|
|
10.12 "Thermodynamic output options"_mod_12 :b
|
|
|
|
|
10.13 "Variable options"_mod_13 :b
|
|
|
|
|
10.14 "Submitting new features for inclusion in LAMMPS"_mod_14 :ule,b
|
2010-11-02 23:05:51 +08:00
|
|
|
"Python interface"_Section_python.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
11.1 "Extending Python with a serial version of LAMMPS"_py_1 :ulb,b
|
|
|
|
|
11.2 "Creating a shared MPI library"_py_2 :b
|
|
|
|
|
11.3 "Extending Python with a parallel version of LAMMPS"_py_3 :b
|
|
|
|
|
11.4 "Extending Python with MPI"_py_4 :b
|
|
|
|
|
11.5 "Testing the Python-LAMMPS interface"_py_5 :b
|
|
|
|
|
11.6 "Using LAMMPS from Python"_py_6 :b
|
|
|
|
|
11.7 "Example Python scripts that use LAMMPS"_py_7 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
"Errors"_Section_errors.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
12.1 "Common problems"_err_1 :ulb,b
|
|
|
|
|
12.2 "Reporting bugs"_err_2 :b
|
|
|
|
|
12.3 "Error & warning messages"_err_3 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
"Future and history"_Section_history.html :l
|
2011-08-26 00:46:23 +08:00
|
|
|
13.1 "Coming attractions"_hist_1 :ulb,b
|
|
|
|
|
13.2 "Past versions"_hist_2 :ule,b
|
2006-09-22 00:22:34 +08:00
|
|
|
:ole
|
|
|
|
|
|
2011-08-26 00:46:23 +08:00
|
|
|
:link(intro_1,Section_intro.html#intro_1)
|
|
|
|
|
:link(intro_2,Section_intro.html#intro_2)
|
|
|
|
|
:link(intro_3,Section_intro.html#intro_3)
|
|
|
|
|
:link(intro_4,Section_intro.html#intro_4)
|
|
|
|
|
:link(intro_5,Section_intro.html#intro_5)
|
|
|
|
|
|
|
|
|
|
:link(start_1,Section_start.html#start_1)
|
|
|
|
|
:link(start_2,Section_start.html#start_2)
|
|
|
|
|
:link(start_3,Section_start.html#start_3)
|
|
|
|
|
:link(start_4,Section_start.html#start_4)
|
|
|
|
|
:link(start_5,Section_start.html#start_5)
|
|
|
|
|
:link(start_6,Section_start.html#start_6)
|
|
|
|
|
:link(start_7,Section_start.html#start_7)
|
|
|
|
|
:link(start_8,Section_start.html#start_8)
|
2012-01-28 07:39:14 +08:00
|
|
|
:link(start_9,Section_start.html#start_9)
|
2011-08-26 00:46:23 +08:00
|
|
|
|
|
|
|
|
:link(cmd_1,Section_commands.html#cmd_1)
|
|
|
|
|
:link(cmd_2,Section_commands.html#cmd_2)
|
|
|
|
|
:link(cmd_3,Section_commands.html#cmd_3)
|
|
|
|
|
:link(cmd_4,Section_commands.html#cmd_4)
|
|
|
|
|
:link(cmd_5,Section_commands.html#cmd_5)
|
|
|
|
|
|
|
|
|
|
:link(pkg_1,Section_packages.html#pkg_1)
|
|
|
|
|
:link(pkg_2,Section_packages.html#pkg_2)
|
|
|
|
|
|
|
|
|
|
:link(acc_1,Section_accelerate.html#acc_1)
|
|
|
|
|
:link(acc_2,Section_accelerate.html#acc_2)
|
|
|
|
|
:link(acc_3,Section_accelerate.html#acc_3)
|
|
|
|
|
:link(acc_4,Section_accelerate.html#acc_4)
|
|
|
|
|
:link(acc_5,Section_accelerate.html#acc_5)
|
2012-08-07 06:50:52 +08:00
|
|
|
:link(acc_6,Section_accelerate.html#acc_6)
|
|
|
|
|
:link(acc_7,Section_accelerate.html#acc_7)
|
|
|
|
|
:link(acc_8,Section_accelerate.html#acc_8)
|
2011-08-26 00:46:23 +08:00
|
|
|
|
|
|
|
|
:link(howto_1,Section_howto.html#howto_1)
|
|
|
|
|
:link(howto_2,Section_howto.html#howto_2)
|
|
|
|
|
:link(howto_3,Section_howto.html#howto_3)
|
|
|
|
|
:link(howto_4,Section_howto.html#howto_4)
|
|
|
|
|
:link(howto_5,Section_howto.html#howto_5)
|
|
|
|
|
:link(howto_6,Section_howto.html#howto_6)
|
|
|
|
|
:link(howto_7,Section_howto.html#howto_7)
|
|
|
|
|
:link(howto_8,Section_howto.html#howto_8)
|
|
|
|
|
:link(howto_9,Section_howto.html#howto_9)
|
|
|
|
|
:link(howto_10,Section_howto.html#howto_10)
|
|
|
|
|
:link(howto_11,Section_howto.html#howto_11)
|
|
|
|
|
:link(howto_12,Section_howto.html#howto_12)
|
|
|
|
|
:link(howto_13,Section_howto.html#howto_13)
|
|
|
|
|
:link(howto_14,Section_howto.html#howto_14)
|
|
|
|
|
:link(howto_15,Section_howto.html#howto_15)
|
|
|
|
|
:link(howto_16,Section_howto.html#howto_16)
|
|
|
|
|
:link(howto_17,Section_howto.html#howto_17)
|
|
|
|
|
:link(howto_18,Section_howto.html#howto_18)
|
|
|
|
|
:link(howto_19,Section_howto.html#howto_19)
|
|
|
|
|
:link(howto_20,Section_howto.html#howto_20)
|
|
|
|
|
:link(howto_21,Section_howto.html#howto_21)
|
|
|
|
|
|
|
|
|
|
:link(mod_1,Section_modify.html#mod_1)
|
|
|
|
|
:link(mod_2,Section_modify.html#mod_2)
|
|
|
|
|
:link(mod_3,Section_modify.html#mod_3)
|
|
|
|
|
:link(mod_4,Section_modify.html#mod_4)
|
|
|
|
|
:link(mod_5,Section_modify.html#mod_5)
|
|
|
|
|
:link(mod_6,Section_modify.html#mod_6)
|
|
|
|
|
:link(mod_7,Section_modify.html#mod_7)
|
|
|
|
|
:link(mod_8,Section_modify.html#mod_8)
|
|
|
|
|
:link(mod_9,Section_modify.html#mod_9)
|
|
|
|
|
:link(mod_10,Section_modify.html#mod_10)
|
|
|
|
|
:link(mod_11,Section_modify.html#mod_11)
|
|
|
|
|
:link(mod_12,Section_modify.html#mod_12)
|
|
|
|
|
:link(mod_13,Section_modify.html#mod_13)
|
|
|
|
|
:link(mod_14,Section_modify.html#mod_14)
|
|
|
|
|
|
|
|
|
|
:link(py_1,Section_python.html#py_1)
|
|
|
|
|
:link(py_2,Section_python.html#py_2)
|
|
|
|
|
:link(py_3,Section_python.html#py_3)
|
|
|
|
|
:link(py_4,Section_python.html#py_4)
|
|
|
|
|
:link(py_5,Section_python.html#py_5)
|
|
|
|
|
:link(py_6,Section_python.html#py_6)
|
|
|
|
|
:link(py_7,Section_python.html#py_7)
|
|
|
|
|
|
|
|
|
|
:link(err_1,Section_errors.html#err_1)
|
|
|
|
|
:link(err_2,Section_errors.html#err_2)
|
|
|
|
|
:link(err_3,Section_errors.html#err_3)
|
|
|
|
|
|
|
|
|
|
:link(hist_1,Section_history.html#hist_1)
|
|
|
|
|
:link(hist_2,Section_history.html#hist_2)
|
2007-09-28 07:25:52 +08:00
|
|
|
|
|
|
|
|
</BODY>
|
