drpengyuhuang / liggghts_flexible_fibers

This is a modified version of LIGGGHTS that includes granular bond formulations. The original version of LIGGGHTS produced by CFDEM can be found here: https://github.com/CFDEMproject/LIGGGHTS-PUBLIC

README File

Link to current Documentation

https://htmlpreview.github.io/?https://raw.githubusercontent.com/schrummy14/LIGGGHTS_Flexible_Fibers/master/doc/Manual.html

Description of Added Files

This package contains a user-created expansion to LIGGGHTS-PUBLIC. Specifically, this adds flexible stiff fibers to LIGGGHTS, like wheat straw, plastic straws, grass, and others. You will find examples on how to use this package in examples/BondPackage. This is an updated version of the bond package first completed by richti83 for LIGGGHTS 3.3 (https://github.com/richti83/LIGGGHTS-WITH-BONDS). If you find this work helpful to you, please also reference the following paper, along with the LIGGGHTS paper.

Schramm, M., Tekeste, M. Z., Plouffe, C., & Harby, D. (2019). Estimating bond damping and bond Young's modulus for a flexible wheat straw discrete element method model. Biosystems Engineering, 186, 349-355. https://doi.org/10.1016/j.biosystemseng.2019.08.003

Thank you to the Department of Particulate Flow Modelling at Johannes Kepler University in Linz, Austria http://www.jku.at/pfm for releasing their dynamic insertion code!

This also contains the source files for the JKR contact model as provided by eidevag (https://github.com/eidevag/LIGGGHTS-PUBLIC-JKR). Please cite the following paper when utilizing the JKR model.

Eidevåg, T., Abrahamsson, P., Eng, M., & Rasmuson, A. (2019). Modeling of dry snow adhesion during normal impact with surfaces. Powder Technology, 361, 1081–1092. https://doi.org/10.1016/j.powtec.2019.10.085

---

Original README test file

---

This is the

██╗     ██╗ ██████╗  ██████╗  ██████╗ ██╗  ██╗████████╗███████╗
██║     ██║██╔════╝ ██╔════╝ ██╔════╝ ██║  ██║╚══██╔══╝██╔════╝
██║     ██║██║  ███╗██║  ███╗██║  ███╗███████║   ██║   ███████╗
██║     ██║██║   ██║██║   ██║██║   ██║██╔══██║   ██║   ╚════██║
███████╗██║╚██████╔╝╚██████╔╝╚██████╔╝██║  ██║   ██║   ███████║
╚══════╝╚═╝ ╚═════╝  ╚═════╝  ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝®

DEM simulation engine, released by

DCS Computing GmbH, Linz, Austria

www.dcs-computing.com, [email protected]

LIGGGHTS® is open-source, distributed under the terms of the GNU Public License, version 2 or later.

LIGGGHTS® is part of CFDEM®project:

https://www.liggghts.com | https://www.cfdem.com

Core developer and main author: Christoph Kloss, [email protected]

LIGGGHTS® and CFDEM® are registered trade marks of DCS Computing GmbH, the producer of the LIGGGHTS® software and the CFDEM®coupling software See http://www.cfdem.com/terms-trademark-policy for details.

---

Copyright 2012- DCS Computing GmbH, Linz

Copyright 2009-2015 JKU Linz

Some parts of LIGGGHTS® are based on LAMMPS and Copyright on these parts is held by Sandia Corporation and other parties. Info on LAMMPS below Some parts of LIGGGHTS® are contributied by other parties, which are holding the Copyright. This is listed in each file of the distribution.

---

The LIGGGHTS® distribution includes the following files and directories:

README          this file
LICENSE         the GNU General Public License (GPL)
doc             documentation
examples        simple example simulation setups
lib             libraries LIGGGHTS® can be linked with
python          Python wrapper on LIGGGHTS® as a library
src             source files

Point your browser at any of these files to get started:

doc/Manual.html            the manual
doc/Section_intro.html     hi-level introduction
doc/Section_start.html     how to build and use

---

Some parts of LIGGGHTS® are based on LAMMPS

LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel Simulator.

LAMMPS is Copyright (2003) Sandia Corporation. Under the terms of Contract

DE-AC04-94AL85000

with Sandia Corporation, the U.S. Government retains certain rights in this software. This software is distributed under the GNU General Public License.

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 author of LAMMPS is Steve Plimpton, who can be emailed at [email protected]. The LAMMPS WWW Site at https://lammps.sandia.gov has more information about the code and its uses.

---

Core developer and main author of LIGGGHTS®: Christoph Kloss, [email protected]