451 lines
12 KiB
HTML
451 lines
12 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>LIGGGHTS Users Manual</TITLE>
|
|
<META NAME="docnumber" CONTENT="Large-scale Atomic/Molecular Massively Parallel Simulator">
|
|
<META NAME="author" CONTENT="http://lammps.sandia.gov - Sandia National Laboratories">
|
|
<META NAME="copyright" CONTENT="Copyright 2009 - 2012 JKU Linz, Copyright 2012 - DCS Computing GmbH, Copyright (2003) Sandia Corporation. This software and manual is distributed under the GNU General Public License.">
|
|
</HEAD>
|
|
|
|
<BODY>
|
|
|
|
<CENTER><A HREF = "http://www.cfdem.com">LIGGGHTS WWW Site</A> - <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LIGGGHTS Documentation</A> - <A HREF = "Section_commands.html#comm">LIGGGHTS Commands</A>
|
|
</CENTER>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<HR>
|
|
|
|
<HR><H1></H1>
|
|
|
|
|
|
<CENTER><H3>LIGGGHTS Documentation, Version 3.X
|
|
</H3></CENTER>
|
|
<HR>
|
|
|
|
<CENTER><IMG SRC = "Portfolio_LIGGGHTS.png">
|
|
</CENTER>
|
|
<HR>
|
|
|
|
<P>LIGGGHTS stands for LAMMPS Improved for General Granular and Granular
|
|
Heat Transfer Simulations. It is part of the <A HREF = "http://www.cfdem.com">CFDEMproject</A>, www.cfdem.com
|
|
</P>
|
|
<P>The core developers of LIGGGHTS are Christoph Kloss (DCS Computing GmbH, Linz and JKU Linz)
|
|
and Richard Berger (JKU Linz), with major contributions from Philippe Seil, Andreas Aigner
|
|
and Stefan Amberger (all JKU Linz) and Christoph Goniva (DCS Computing GmbH, Linz and JKU Linz)
|
|
</P>
|
|
<P><A HREF = "http://www.cfdem.com">CFDEMproject</A> has more information about the code and its uses.
|
|
For questions about the code, please use the forums at <A HREF = "http://www.cfdem.com">CFDEMproject</A>.
|
|
</P>
|
|
<P>LIGGGHTS is based on LAMMPS (see below), and so is its manual. So if the manual says
|
|
'LAMMPS', you could read 'LIGGGHTS' instead. However, we want to make clear which
|
|
parts of the code and framework stem from the LAMMPS base.
|
|
</P>
|
|
<H4>LIGGGHTS Version info:
|
|
</H4>
|
|
<P>All LIGGGHTS versions are based on a specific version of LAMMPS, as printed in
|
|
the file src/version.h LIGGGHTS version are identidied by a version number (e.g. '3.0'),
|
|
a branch name (e.g. 'LIGGGHTS-PUBLIC' for the public release of LIGGGHTS),
|
|
compilation info (date / time stamp and user name), and a LAMMPS version
|
|
number (which is the LAMMPS version that the LIGGGHTS release is based on).
|
|
For info on the LAMMPS version, see below.
|
|
</P>
|
|
<H4>LAMMPS Version info:
|
|
</H4>
|
|
<P>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 <A HREF = "http://lammps.sandia.gov/bug.html">this page of
|
|
the WWW site</A>. 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
|
|
directory name created when you unpack a tarball, and at the top of
|
|
the first page of the manual (this page).
|
|
</P>
|
|
<UL><LI>If you browse the HTML doc pages on the LAMMPS WWW site, they always
|
|
describe the most current version of LAMMPS.
|
|
|
|
<LI>If you browse the HTML doc pages included in your tarball, they
|
|
describe the version you have.
|
|
|
|
<LI>The <A HREF = "Manual.pdf">PDF file</A> on the WWW site or in the tarball is updated
|
|
about once per month. This is because it is large, and we don't want
|
|
it to be part of every patch.
|
|
|
|
<LI>There is also a <A HREF = "Developer.pdf">Developer.pdf</A> file in the doc
|
|
directory, which describes the internal structure and algorithms of
|
|
LAMMPS.
|
|
</UL>
|
|
<P>LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel
|
|
Simulator.
|
|
</P>
|
|
<P>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).
|
|
</P>
|
|
<P>The primary developers of LAMMPS are <A HREF = "http://www.sandia.gov/~sjplimp">Steve Plimpton</A>, Aidan
|
|
Thompson, and Paul Crozier who can be contacted at
|
|
sjplimp,athomps,pscrozi at sandia.gov. The <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> at
|
|
http://lammps.sandia.gov has more information about the code and its
|
|
uses.
|
|
</P>
|
|
|
|
|
|
|
|
|
|
<HR>
|
|
|
|
<P>The LAMMPS documentation is organized into the following sections. If
|
|
you find errors or omissions in this manual or have suggestions for
|
|
useful information to add, please send an email to the developers so
|
|
we can improve the LAMMPS documentation.
|
|
</P>
|
|
<P>Once you are familiar with LAMMPS, you may want to bookmark <A HREF = "Section_commands.html#comm">this
|
|
page</A> at Section_commands.html#comm since
|
|
it gives quick access to documentation for all LAMMPS commands.
|
|
</P>
|
|
<P><A HREF = "Manual.pdf">PDF file</A> of the entire manual, generated by
|
|
<A HREF = "http://www.easysw.com/htmldoc">htmldoc</A>
|
|
</P>
|
|
<OL><LI><A HREF = "Section_intro.html">Introduction</A>
|
|
|
|
<UL> 1.1 <A HREF = "Section_intro.html#intro_1">What is LAMMPS</A>
|
|
<BR>
|
|
1.2 <A HREF = "Section_intro.html#intro_2">LAMMPS features</A>
|
|
<BR>
|
|
1.3 <A HREF = "Section_intro.html#intro_3">LAMMPS non-features</A>
|
|
<BR>
|
|
1.4 <A HREF = "Section_intro.html#intro_4">Open source distribution</A>
|
|
<BR>
|
|
1.5 <A HREF = "Section_intro.html#intro_5">Acknowledgments and citations</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_start.html">Getting started</A>
|
|
|
|
<UL> 2.1 <A HREF = "Section_start.html#start_1">What's in the LAMMPS distribution</A>
|
|
<BR>
|
|
2.2 <A HREF = "Section_start.html#start_2">Making LAMMPS</A>
|
|
<BR>
|
|
2.3 <A HREF = "Section_start.html#start_3">Making LAMMPS with optional packages</A>
|
|
<BR>
|
|
2.4 <A HREF = "Section_start.html#start_4">Building LAMMPS via the Make.py script</A>
|
|
<BR>
|
|
2.5 <A HREF = "Section_start.html#start_5">Building LAMMPS as a library</A>
|
|
<BR>
|
|
2.6 <A HREF = "Section_start.html#start_6">Running LAMMPS</A>
|
|
<BR>
|
|
2.7 <A HREF = "Section_start.html#start_7">Command-line options</A>
|
|
<BR>
|
|
2.8 <A HREF = "Section_start.html#start_8">Screen output</A>
|
|
<BR>
|
|
2.9 <A HREF = "Section_start.html#start_9">Tips for users of previous versions</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_commands.html">Commands</A>
|
|
|
|
<UL> 3.1 <A HREF = "Section_commands.html#cmd_1">LAMMPS input script</A>
|
|
<BR>
|
|
3.2 <A HREF = "Section_commands.html#cmd_2">Parsing rules</A>
|
|
<BR>
|
|
3.3 <A HREF = "Section_commands.html#cmd_3">Input script structure</A>
|
|
<BR>
|
|
3.4 <A HREF = "Section_commands.html#cmd_4">Commands listed by category</A>
|
|
<BR>
|
|
3.5 <A HREF = "Section_commands.html#cmd_5">Commands listed alphabetically</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_packages.html">Packages</A>
|
|
|
|
<UL> 4.1 <A HREF = "Section_packages.html#pkg_1">Standard packages</A>
|
|
<BR>
|
|
4.2 <A HREF = "Section_packages.html#pkg_2">User packages</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_accelerate.html">Accelerating LAMMPS performance</A>
|
|
|
|
<UL> 5.1 <A HREF = "Section_accelerate.html#acc_1">Measuring performance</A>
|
|
<BR>
|
|
5.2 <A HREF = "Section_accelerate.html#acc_2">General strategies</A>
|
|
<BR>
|
|
5.3 <A HREF = "Section_accelerate.html#acc_3">Packages with optimized styles</A>
|
|
<BR>
|
|
5.4 <A HREF = "Section_accelerate.html#acc_4">OPT package</A>
|
|
<BR>
|
|
5.5 <A HREF = "Section_accelerate.html#acc_5">USER-OMP package</A>
|
|
<BR>
|
|
5.6 <A HREF = "Section_accelerate.html#acc_6">GPU package</A>
|
|
<BR>
|
|
5.7 <A HREF = "Section_accelerate.html#acc_7">USER-CUDA package</A>
|
|
<BR>
|
|
5.8 <A HREF = "Section_accelerate.html#acc_8">Comparison of GPU and USER-CUDA packages</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_howto.html">How-to discussions</A>
|
|
|
|
<UL> 6.1 <A HREF = "Section_howto.html#howto_1">Restarting a simulation</A>
|
|
<BR>
|
|
6.2 <A HREF = "Section_howto.html#howto_2">2d simulations</A>
|
|
<BR>
|
|
6.3 <A HREF = "Section_howto.html#howto_3">CHARMM and AMBER force fields</A>
|
|
<BR>
|
|
6.4 <A HREF = "Section_howto.html#howto_4">Running multiple simulations from one input script</A>
|
|
<BR>
|
|
6.5 <A HREF = "Section_howto.html#howto_5">Multi-replica simulations</A>
|
|
<BR>
|
|
6.6 <A HREF = "Section_howto.html#howto_6">Granular models</A>
|
|
<BR>
|
|
6.7 <A HREF = "Section_howto.html#howto_7">TIP3P water model</A>
|
|
<BR>
|
|
6.8 <A HREF = "Section_howto.html#howto_8">TIP4P water model</A>
|
|
<BR>
|
|
6.9 <A HREF = "Section_howto.html#howto_9">SPC water model</A>
|
|
<BR>
|
|
6.10 <A HREF = "Section_howto.html#howto_10">Coupling LAMMPS to other codes</A>
|
|
<BR>
|
|
6.11 <A HREF = "Section_howto.html#howto_11">Visualizing LAMMPS snapshots</A>
|
|
<BR>
|
|
6.12 <A HREF = "Section_howto.html#howto_12">Triclinic (non-orthogonal) simulation boxes</A>
|
|
<BR>
|
|
6.13 <A HREF = "Section_howto.html#howto_13">NEMD simulations</A>
|
|
<BR>
|
|
6.14 <A HREF = "Section_howto.html#howto_14">Finite-size spherical and aspherical particles</A>
|
|
<BR>
|
|
6.15 <A HREF = "Section_howto.html#howto_15">Output from LAMMPS (thermo, dumps, computes, fixes, variables)</A>
|
|
<BR>
|
|
6.16 <A HREF = "Section_howto.html#howto_16">Thermostatting, barostatting, and compute temperature</A>
|
|
<BR>
|
|
6.17 <A HREF = "Section_howto.html#howto_17">Walls</A>
|
|
<BR>
|
|
6.18 <A HREF = "Section_howto.html#howto_18">Elastic constants</A>
|
|
<BR>
|
|
6.19 <A HREF = "Section_howto.html#howto_19">Library interface to LAMMPS</A>
|
|
<BR>
|
|
6.20 <A HREF = "Section_howto.html#howto_20">Calculating thermal conductivity</A>
|
|
<BR>
|
|
6.21 <A HREF = "Section_howto.html#howto_21">Calculating viscosity</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_example.html">Example problems</A>
|
|
|
|
<LI><A HREF = "Section_perf.html">Performance & scalability</A>
|
|
|
|
<LI><A HREF = "Section_tools.html">Additional tools</A>
|
|
|
|
<LI><A HREF = "Section_modify.html">Modifying & extending LAMMPS</A>
|
|
|
|
<UL> 10.1 <A HREF = "Section_modify.html#mod_1">Atom styles</A>
|
|
<BR>
|
|
10.2 <A HREF = "Section_modify.html#mod_2">Bond, angle, dihedral, improper potentials</A>
|
|
<BR>
|
|
10.3 <A HREF = "Section_modify.html#mod_3">Compute styles</A>
|
|
<BR>
|
|
10.4 <A HREF = "Section_modify.html#mod_4">Dump styles</A>
|
|
<BR>
|
|
10.5 <A HREF = "Section_modify.html#mod_5">Dump custom output options</A>
|
|
<BR>
|
|
10.6 <A HREF = "Section_modify.html#mod_6">Fix styles</A>
|
|
<BR>
|
|
10.7 <A HREF = "Section_modify.html#mod_7">Input script commands</A>
|
|
<BR>
|
|
10.8 <A HREF = "Section_modify.html#mod_8">Kspace computations</A>
|
|
<BR>
|
|
10.9 <A HREF = "Section_modify.html#mod_9">Minimization styles</A>
|
|
<BR>
|
|
10.10 <A HREF = "Section_modify.html#mod_10">Pairwise potentials</A>
|
|
<BR>
|
|
10.11 <A HREF = "Section_modify.html#mod_11">Region styles</A>
|
|
<BR>
|
|
10.12 <A HREF = "Section_modify.html#mod_12">Body styles</A>
|
|
<BR>
|
|
10.13 <A HREF = "Section_modify.html#mod_13">Thermodynamic output options</A>
|
|
<BR>
|
|
10.14 <A HREF = "Section_modify.html#mod_14">Variable options</A>
|
|
<BR>
|
|
10.15 <A HREF = "Section_modify.html#mod_15">Submitting new features for inclusion in LAMMPS</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_python.html">Python interface</A>
|
|
|
|
<UL> 11.1 <A HREF = "Section_python.html#py_1">Building LAMMPS as a shared library</A>
|
|
<BR>
|
|
11.2 <A HREF = "Section_python.html#py_2">Installing the Python wrapper into Python</A>
|
|
<BR>
|
|
11.3 <A HREF = "Section_python.html#py_3">Extending Python with MPI to run in parallel</A>
|
|
<BR>
|
|
11.4 <A HREF = "Section_python.html#py_4">Testing the Python-LAMMPS interface</A>
|
|
<BR>
|
|
11.5 <A HREF = "Section_python.html#py_5">Using LAMMPS from Python</A>
|
|
<BR>
|
|
11.6 <A HREF = "Section_python.html#py_6">Example Python scripts that use LAMMPS</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_errors.html">Errors</A>
|
|
|
|
<UL> 12.1 <A HREF = "Section_errors.html#err_1">Common problems</A>
|
|
<BR>
|
|
12.2 <A HREF = "Section_errors.html#err_2">Reporting bugs</A>
|
|
<BR>
|
|
12.3 <A HREF = "Section_errors.html#err_3">Error & warning messages</A>
|
|
<BR></UL>
|
|
<LI><A HREF = "Section_history.html">Future and history</A>
|
|
|
|
<UL> 13.1 <A HREF = "Section_history.html#hist_1">Coming attractions</A>
|
|
<BR>
|
|
13.2 <A HREF = "Section_history.html#hist_2">Past versions</A>
|
|
<BR></UL>
|
|
|
|
</OL>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</BODY>
|
|
|
|
</HTML>
|