LIGGGHTS(R)-PUBLIC Users Manual
Author: http://www.cfdem.com - DCS Computing GmbH

LIGGGHTS(R)-PUBLIC WWW Site - LIGGGHTS(R)-PUBLIC Documentation - LIGGGHTS(R)-PUBLIC Commands

#

### LIGGGHTS(R)-PUBLIC Documentation, Version 3.X

### LIGGGHTS(R)-PUBLIC DEM simulation engine

### released by DCS Computing Gmbh, Linz, Austria, www.dcs-computing.com , office@dcs-computing.com

#### LIGGGHTS(R)-PUBLIC is open-source, distributed under the terms of the GNU Public License, version 2 or later. LIGGGHTS(R)-PUBLIC is part of CFDEM(R)project: www.liggghts.com | www.cfdem.com

Core developer and main author: Christoph Kloss, christoph.kloss@dcs-computing.com

#### LIGGGHTS(R)-PUBLIC is an Open Source Discrete Element Method Particle Simulation Software, distributed by DCS Computing GmbH, Linz, Austria. LIGGGHTS (R) and CFDEM(R) are registered trade marks of DCS Computing GmbH, the producer of the LIGGGHTS (R) software and the CFDEM(R)coupling software See http://www.cfdem.com/terms-trademark-policy for details.

#### LIGGGHTS (R) Version info:

All LIGGGHTS (R) versions are based on a specific version of LIGGGHTS (R), as printed in the file src/version.h LIGGGHTS (R) versions are identidied by a version number (e.g. '3.0'), a branch name (which is 'LIGGGHTS(R)-PUBLIC' for your release of LIGGGHTS), compilation info (date / time stamp and user name), and a LAMMPS version number (which is the LAMMPS version that the LIGGGHTS(R)-PUBLIC release is based on). The LAMMPS "version" is the date when it was released, such as 1 May 2010.

If you browse the HTML doc pages on the LIGGGHTS(R)-PUBLIC WWW site, they always describe the most current version of LIGGGHTS(R)-PUBLIC. If you browse the HTML doc pages included in your tarball, they describe the version you have.

#### LIGGGHTS (R) and its ancestor LAMMPS:

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). The primary developers of LAMMPS are Steve Plimpton, Aidan Thompson, and Paul Crozier. The LAMMPS WWW Site at http://lammps.sandia.gov has more information about LAMMPS.

The LIGGGHTS(R)-PUBLIC 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 LIGGGHTS(R)-PUBLIC documentation.

Once you are familiar with LIGGGHTS(R)-PUBLIC, you may want to bookmark this page since it gives quick access to documentation for all LIGGGHTS(R)-PUBLIC commands.

1. Introduction
   1.1 What is LIGGGHTS(R)-PUBLIC
   1.2 LIGGGHTS(R)-PUBLIC features
   1.3 Open source distribution
   1.4 Acknowledgments and citations
2. Getting started
   2.1 What's in the LIGGGHTS(R)-PUBLIC distribution
   2.2 Making LIGGGHTS(R)-PUBLIC
   2.3 Making LIGGGHTS(R)-PUBLIC with optional packages
   2.4 Building LIGGGHTS(R)-PUBLIC via the Make.py script
   2.5 Building LIGGGHTS(R)-PUBLIC as a library
   2.6 Running LIGGGHTS(R)-PUBLIC
   2.7 Command-line options
   2.8 Screen output
3. Input script
   3.1 LIGGGHTS(R)-PUBLIC input script
   3.2 Parsing rules
   3.3 Input script structure
4. Commands 4.1 List of available commands
5. Contact models 5.1 List of available contact models
6. Packages
   6.1 Standard packages
   6.2 User packages
7. How-to discussions
   7.1 Restarting a simulation
   7.2 2d simulations
   7.3 Running multiple simulations from one input script
   7.4 Granular models
   7.5 Coupling LIGGGHTS(R)-PUBLIC to other codes
   7.6 Visualizing LIGGGHTS(R)-PUBLIC snapshots
   7.7 Triclinic (non-orthogonal) simulation boxes
   7.8 Output from LIGGGHTS(R)-PUBLIC (thermo, dumps, computes, fixes, variables)
   7.9 Walls
   7.10 Library interface to LIGGGHTS(R)-PUBLIC
8. Modifying & extending LIGGGHTS(R)-PUBLIC
   8.1 Atom styles
   8.2 Compute styles
   8.4 Dump styles
   8.5 Dump custom output options
   8.6 Fix styles
   8.6 Input script commands
   8.7 Pairwise potentials
   8.8 Region styles
   8.9 Thermodynamic output options
   8.10 Variable options
   8.11 Submitting new features for inclusion in LIGGGHTS(R)-PUBLIC
9. Python interface
   9.1 Building LIGGGHTS(R)-PUBLIC as a shared library
   9.2 Installing the Python wrapper into Python
   9.3 Extending Python with MPI to run in parallel
   9.4 Testing the Python-LIGGGHTS(R)-PUBLIC interface
   9.5 Using LIGGGHTS(R)-PUBLIC from Python
   9.6 Example Python scripts that use LIGGGHTS(R)-PUBLIC
10. Errors
    10.1 Common problems
    10.2 Reporting bugs
    10.3 Error & warning messages