---

LIGGGHTS(R)-INL Documentation, Version 4.X

---

---

LIGGGHTS(R)-INL DEM simulation engine

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

---

LIGGGHTS(R)-INL is open-source, distributed under the terms of the GNU Public License, version 2 or later. LIGGGHTS(R)-INL 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)-INL 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)-INL’ 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)-INL 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)-INL WWW site, they always describe the most current version of LIGGGHTS(R)-INL. 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)-INL 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)-INL documentation.

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

• 1. Introduction
  • 1.1. What is LIGGGHTS(R)-INL
  • 1.2. LIGGGHTS-PUBLIC VS. LIGGGHTS-PREMIUM
  • 1.3. History
  • 1.4. LIGGGHTS(R)-INL features
  • 1.5. LIGGGHTS(R)-INL General features
  • 1.6. LIGGGHTS(R)-INL Model features: LIGGGHTS-PUBLIC features
  • 1.7. LIGGGHTS(R)-INL Model features: Additional features for LIGGGHTS(R)-INL
  • 1.8. Open source distribution
  • 1.9. Acknowledgments and citations
• 2. Getting Started
  • 2.1. How to obtain LIGGGHTS(R)-INL
  • 2.2. Making LIGGGHTS(R)-INL
  • 2.3. Making LIGGGHTS(R)-INL with optional packages
  • 2.4. Building LIGGGHTS(R)-INL via the Make.py script
  • 2.5. Building LIGGGHTS(R)-INL as a library
  • 2.6. Running LIGGGHTS(R)-INL
  • 2.7. Command-line options
  • 2.8. LIGGGHTS(R)-INL screen output
• 3. Input Script
  • 3.1. LIGGGHTS(R)-INL input script
  • 3.2. Parsing rules
  • 3.3. Input script structure
  • 3.4. An example input script
• 4. Commands
  • 4.1. List of all commands
  • 4.2. bond_style potentials
  • 4.3. compute styles
  • 4.4. dump styles
  • 4.5. fix styles
  • 4.6. pair_style potentials
• 5. Contact models
  • 5.1. cohesion commands
  • 5.2. model commands
  • 5.3. rolling_friction commands
  • 5.4. surface commands
  • 5.5. tangential commands
• 6. Mesh modules
  • 6.1. module commands
• 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)-INL to other codes
  • 8.6. Visualizing LIGGGHTS(R)-INL snapshots
  • 8.7. Triclinic (non-orthogonal) simulation boxes
  • 8.8. Output from LIGGGHTS(R)-INL (thermo, dumps, computes, fixes, variables)
  • 8.9. Walls
  • 8.10. Library interface to LIGGGHTS(R)-INL
• 9. Modifying & extending LIGGGHTS(R)-INL
  • 9.1. Atom styles
  • 9.2. Compute styles
  • 9.3. Dump styles
  • 9.4. Dump custom output options
  • 9.5. Fix styles
  • 9.6. Input script commands
  • 9.7. Pairwise potentials
  • 9.8. Region styles
  • 9.9. Thermodynamic output options
  • 9.10. Variable options
  • 9.11. Submitting new features for inclusion in LIGGGHTS(R)-INL
• 10. Python interface to LIGGGHTS(R)-INL
  • 10.1. Building LIGGGHTS(R)-INL 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)-INL interface
  • 10.5. Using LIGGGHTS(R)-INL from Python
  • 10.6. Example Python scripts that use LIGGGHTS(R)-INL
• 11. Errors
  • 11.1. Common problems
  • 11.2. Reporting bugs
  • 11.3. Error & warning messages
  • 11.4. Errors:
  • 11.5. Warnings:

Indices and tables

• Index
• Search Page