"Previous Section"_Manual.html - "LIGGGHTS(R)-PUBLIC WWW Site"_lws - "LIGGGHTS(R)-PUBLIC Documentation"_ld - "LIGGGHTS(R)-PUBLIC Commands"_lc - "Next Section"_Section_start.html :c

:link(liws,http://www.cfdem.com)
:link(ld,Manual.html)
:link(lc,Section_commands.html#comm)

:line

1. Introduction :h3

This section provides an overview of what LIGGGHTS(R)-PUBLIC can do,
describes what it means for LIGGGHTS(R)-PUBLIC to be an open-source code, and
acknowledges the funding and people who have contributed to LIGGGHTS(R)-PUBLIC
over the years.

1.1 "What is LIGGGHTS(R)-PUBLIC"_#intro_1
1.2 "LIGGGHTS(R)-PUBLIC features"_#intro_2
1.3 "Open source distribution"_#intro_3
1.4 "Acknowledgments and citations"_#intro_4 :all(b)

:line
:line

1.1 What is LIGGGHTS(R)-PUBLIC :link(intro_1),h4

LIGGGHTS(R)-PUBLIC is an Open Source Discrete Element Method Particle
Simulation Software.

LIGGGHTS (R) stands for LAMMPS improved for general granular and
granular heat transfer simulations.
LAMMPS is a classical molecular dynamics simulator. It is widely
used in the field of Molecular Dynamics. Thanks to physical and
algorithmic analogies, LAMMPS offers basic functionalities for
DEM simulations. LIGGGHTS (R) aims to improve those capability with
the goal to apply it to industrial applications. LIGGGHTS® is currently
used by a variety of research institutions world-wide. A number of Blue
Chip companies in the fields of chemical, consumer goods, pharmaceutical,
agricultural engineering, food production, steel production, mining,
plastics production use LIGGGHTS (R) for improvement of production processes.
LIGGGHTS(R)-PUBLIC runs efficiently on single-processor desktop or laptop
machines, but is designed for parallel computers.  It will run on any
parallel machine that compiles C++ and supports the "MPI"_mpi
message-passing library.  This includes distributed- or shared-memory
parallel machines.
LIGGGHTS (R) can model systems with only a few particles up to millions or
billions. LIGGGHTS (R) is designed to be easy to modify or extend with new
capabilities, such as new force fields, atom types, boundary
conditions, or diagnostics.  See "Section_modify"_Section_modify.html
for more details.

:link(mpi,http://www-unix.mcs.anl.gov/mpi)

LIGGGHTS(R)-PUBLIC is a freely-available open-source code, distributed under the
terms of the "GNU Public License"_gnu, which means you can use or
modify the code however you wish.  See "this section"_#intro_4 for a
brief discussion of the open-source philosophy.

:link(gnu,http://www.gnu.org/copyleft/gpl.html)

LIGGGHTS-PUBLIC VS. LIGGGHTS-PREMIUM :h4

There are 2 flavors of LIGGGHTS. This documentation may refer to
LIGGGHTS as LIGGGHTS-PUBLIC or as LIGGGHTS-PREMIUM, where PREMIUM
is the name of your company or institution

LIGGGHTS-PUBLIC is the version of LIGGGHTS which is available for public
download at this cite. It offers everything a researcher needs to do simulations:
A large model portfolio, performance, and it is easy to understand and extend with
new capabilities. It is periodically updated, and includes all the contributions
from the community.
LIGGGHTS-PREMIUM is a version with additional features for large-scale industrial
application, available for industrial partner companies of CFDEM(R)project from all
around the world, who have spent several million Euros for developing LIGGGHTS(R)-PUBLIC.
The Premium version is made available to industrial partners and customers as part
of a long-term collaboration involving development projects to further strengthen
the model porfolio of CFDEM(R)project.

History :h4

As the sanme implies, some parts of LIGGGHTS(R)-PUBLIC are based on 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.
LAMMPS was originally developed under a US Department of Energy CRADA
(Cooperative Research and Development Agreement) between two DOE labs
and 3 companies.

:line

1.2 LIGGGHTS(R)-PUBLIC features :link(intro_2),h4

In the most general sense, LIGGGHTS(R)-PUBLIC integrates Newton's equations of
motion for collections of atoms, molecules, or macroscopic particles
that interact via short- or long-range forces with a variety of
initial and/or boundary conditions.  For computational efficiency
LIGGGHTS(R)-PUBLIC uses neighbor lists to keep track of nearby particles.  The
lists are optimized for systems with particles that are repulsive at
short distances, so that the local density of particles never becomes
too large.  On parallel machines, LIGGGHTS(R)-PUBLIC uses spatial-decomposition
techniques to partition the simulation domain into small 3d
sub-domains, one of which is assigned to each processor.  Processors
communicate and store "ghost" atom information for atoms that border
their sub-domain.


LIGGGHTS(R)-PUBLIC General features :h4

  runs on a single processor or in parallel
  distributed-memory message-passing parallelism (MPI)
  spatial-decomposition of simulation domain for parallelism
  open-source distribution
  highly portable C++
  optional libraries used: MPI
  easy to extend with new features and functionality
  runs from an input script
  syntax for defining and using variables and formulas
  syntax for looping over runs and breaking out of loops
  run one or multiple simulations simultaneously (in parallel) from one script
  output to the widely used, open source VTK data format
  build as library, invoke LIGGGHTS(R)-PUBLIC thru library interface or provided Python wrapper
  couple with other codes: LIGGGHTS(R)-PUBLIC calls other code, other code calls LIGGGHTS(R)-PUBLIC, umbrella code calls both
  a strong eco-system of fellow simulation engines for co-simulation, efficienty and tightly coupled via MPI.
  LIGGGHTS(R)-PUBLIC can be coupled to CFDEM(R)coupling for CFD-DEM simulations and Lagrange-Euler coupling in general
  LIGGGHTS(R)-PUBLIC can be coupled to the simulation engine ParScale for the modelling of intra-particle transport processes :ul

LIGGGHTS(R)-PUBLIC Model features: LIGGGHTS-PUBLIC features for  :h4

  import and handling of complex geometries: STL walls and VTK tet volume meshes
  moving mesh feature with a varierty of motion schemes and a model for conveyor belts
  force and wear analysis on meshes as well as stress-controlled walls
  a variety of particle-particle contact implementations, including models for tangential history, non-spericity and cohesion
  interface to easily extend contact implementations
  heat conduction between particles
  particle insertion based on pre-defined volumes, meshes and particle streams from faces as well as particle growth and shrinkage
  flexible definition of particle distributions
  smoothed Particle Hydrodynamics (SPH) fluid models :ul

LIGGGHTS(R)-PUBLIC Model features: Additional features for LIGGGHTS(R)-PUBLIC :h4

LIGGGHTS versions other than LIGGGHTS-PUBLIC have additional functionalities,
which are all described in the doc pages for the different commands.

:line

1.3 Open source distribution :link(intro_3),h4

LIGGGHTS(R)-PUBLIC comes with no warranty of any kind.  As each source file states
in its header, it is a copyrighted code that is distributed free-of-
charge, under the terms of the "GNU Public License"_gnu (GPL).  This
is often referred to as open-source distribution - see
"www.gnu.org"_gnuorg or "www.opensource.org"_opensource for more
details.  The legal text of the GPL is in the LICENSE file that is
included in the LIGGGHTS(R)-PUBLIC distribution.

:link(gnuorg,http://www.gnu.org)
:link(opensource,http://www.opensource.org)

Here is a summary of what the GPL means for LIGGGHTS(R)-PUBLIC users:

(1) Anyone is free to use, modify, or extend LIGGGHTS(R)-PUBLIC in any way they
choose, including for commercial purposes.

(2) If you distribute a modified version of LIGGGHTS(R)-PUBLIC, it must remain
open-source, meaning you distribute it under the terms of the GPL.
You must clearly annotate such a code as a derivative version of
LIGGGHTS(R)-PUBLIC.

(3) If you release any code that includes LIGGGHTS(R)-PUBLIC source code, then it
must also be open-sourced, meaning you distribute it under the terms
of the GPL.

(4) If you give LIGGGHTS(R)-PUBLIC files to someone else, the GPL LICENSE file and
source file headers (including the copyright and GPL notices) must
remain part of the code.

In the spirit of an open-source code, these are various ways you can
contribute to making LIGGGHTS(R)-PUBLIC better. If you find an error, omission or bug
in this manual or in the code, please
"see our website for more info"_http://http://www.cfdem.com/get-involved-contribute
on how to get involved

If you publish a paper using LIGGGHTS(R)-PUBLIC results, send the citation (and
any cool pictures or movies if you like) to add to the Publications,
Pictures, and Movies pages of the our website, with links
and attributions back to you. :l

:line

1.4 Acknowledgments and citations :h4,link(intro_4)

LIGGGHTS(R)-PUBLIC development has been funded by a variety of sources:

  Christian Doppler Forschungsgesellschaft, www.cdg.at
  The EU FP7 programmes NanoSim and T-MAPPP
  The Austrial funding agency FFG, www.ffg.at
  A variety of industrial partners in bi-laterial projects :ul

As LIGGGHTS(R)-PUBLIC is based on LAMMPS, we also acknowledge the funding
that helped creating LAMMPS.  LAMMPS development has been funded by the "US Department of
Energy"_doe (DOE), through its CRADA, LDRD, ASCI, and Genomes-to-Life
programs and its "OASCR"_oascr and "OBER"_ober offices.

Specifically, work on the latest version was funded in part by the US
Department of Energy's Genomics:GTL program
("www.doegenomestolife.org"_gtl) under the "project"_ourgtl, "Carbon
Sequestration in Synechococcus Sp.: From Molecular Machines to
Hierarchical Modeling".

:link(doe,http://www.doe.gov)
:link(gtl,http://www.doegenomestolife.org)
:link(ourgtl,http://www.genomes2life.org)
:link(oascr,http://www.sc.doe.gov/ascr/home.html)
:link(ober,http://www.er.doe.gov/production/ober/ober_top.html)

The following paper describe the basic parallel algorithms used in
LIGGGHTS(R)-PUBLIC.  If you use LIGGGHTS(R)-PUBLIC results in your published work, please cite
"this paper"_citelig and include a pointer to the http://www.cfdem.com site

:link(citelig,http://www.cfdem.com/citing-liggghtsr)
