LMGC90

Introduction

LMGC90 is a free and open source software dedicated to multiple physics simulation of discrete material and structures. More details on the capabilities of LMGC90 are available here.

Modules

The LMGC90, version 2017.rc1 is available on Salomon via module LMGC90:

$ ml LMGC90

The module sets up environment variables and loads some other modules, required for running LMGC90 python scripts. This particular command loads the default module, which is LMGC90/2017.rc1-GCC-6.3.0-2.27, and modules:

GCCcore/6.3.0
binutils/2.27-GCCcore-6.3.0
GCC/6.3.0-2.27
bzip2/1.0.6
zlib/1.2.8
ncurses/6.0
libreadline/6.3
Tcl/8.6.3
SQLite/3.8.8.1
Python/2.7.9

Running Generic Example

LMGC90 software main API is a Python module. It comes with a pre-processor written in Python. There are several examples that you can copy from the examples directory which is in /apps/all/LMGC90/2017.rc1-GCC-6.3.0-2.27 folder. Follow the next steps to run one of them.

First choose an example and open a terminal in the directory of the copied example.

Generation

To have more information on the pre-processor open in a web navigator the file docs/pre_lmgc/index.html.

To run an example, if there is no DATBOX directory or it is empty, run the Python generation script which is mostly called gen_sample.py with the command:

$ python gen_sample.py

You should now have a DATBOX directory containing all needed .DAT and .INI files.

Computation

Now run the command script usually called command.py:

$ python command.py

To get more information on the structure on command scripts read the documentation opening the file docs/chipy/index.html in a web browser. Once the computation is done, you should get the directory OUTBOX containing ASCII output files, and a DISPLAY directory with output file readable by paraview.

Postprocessing and Visualization

The ASCII files in POSTPRO directory result from the commands in the DATBOX/POSTPRO.DAT file. To have more information on how to use these features read the documents manuals/LMGC90_Postpro.pdf. The files inside the DISPLAY directory can be visualized with paraview. It is advised to read the .pvd files which ensure time consistency. The different output files are:

  • tacts: contactors of rigid objects
  • rigids: center of mass of rigid objects
  • inter: interactions
  • mecafe: mechanical mesh
  • therfe: thermal mesh
  • porofe: porous mechanical mesh
  • multife: multi-phasic fluid in porous media mesh