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-PUBLIC VS. LIGGGHTS-PREMIUM
- 1.3. History
- 1.4. LIGGGHTS(R)-PUBLIC features
- 1.5. LIGGGHTS(R)-PUBLIC General features
- 1.6. LIGGGHTS(R)-PUBLIC Model features: LIGGGHTS-PUBLIC features
- 1.7. LIGGGHTS(R)-PUBLIC Model features: Additional features for LIGGGHTS(R)-PUBLIC
- 1.8. Open source distribution
- 1.9. Acknowledgments and citations
- 2. Getting Started
- 2.1. How to obtain LIGGGHTS(R)-PUBLIC
- 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. LIGGGHTS(R)-PUBLIC screen output
- 3. Input Script
- 4. Commands
- 5. Contact models
- 6. Mesh modules
- 7. Packages
- 8. How-to discussions
- 8.1. Restarting a simulation
- 8.2. 2d simulations
- 8.3. Running multiple simulations from one input script
- 8.4. Granular models
- 8.5. Coupling LIGGGHTS(R)-PUBLIC to other codes
- 8.6. Visualizing LIGGGHTS(R)-PUBLIC snapshots
- 8.7. Triclinic (non-orthogonal) simulation boxes
- 8.8. Output from LIGGGHTS(R)-PUBLIC (thermo, dumps, computes, fixes, variables)
- 8.9. Walls
- 8.10. Library interface to LIGGGHTS(R)-PUBLIC
- 9. Modifying & extending LIGGGHTS(R)-PUBLIC
- 10. Python interface to LIGGGHTS(R)-PUBLIC
- 10.1. Building LIGGGHTS(R)-PUBLIC as a shared library
- 10.2. Installing the Python wrapper into Python
- 10.3. Extending Python with MPI to run in parallel
- 10.4. Testing the Python-LIGGGHTS(R)-PUBLIC interface
- 10.5. Using LIGGGHTS(R)-PUBLIC from Python
- 10.6. Example Python scripts that use LIGGGHTS(R)-PUBLIC
- 11. Errors