diff --git a/docs.it4i/salomon/software/phys/LMGC90.md b/docs.it4i/salomon/software/phys/LMGC90.md new file mode 100644 index 0000000000000000000000000000000000000000..1c310fe2595452dfc37ed54085d5ff026814644d --- /dev/null +++ b/docs.it4i/salomon/software/phys/LMGC90.md @@ -0,0 +1,52 @@ +# 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][Welcome]. + +## Modules +The LMGC90, version 2017.rc1 is available on Salomon via module LMGC90: +```sh +$ 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][pre_lmgc]. + +To run an example, if there is no *DATBOX* directory or it is empty, run the Python generation script which is most time called *gen_sample.py* with the command: +```sh +$ 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*: +```sh +$ python command.py +``` +To get more information on the structure on command scripts read the documentation opening the file [docs/chipy/index.html][chipy] in a web browser. +Once the computation is done, you should have 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 this features read the documents [manuals/LMGC90_Postpro.pdf][LMGC90_Postpro.pdf]. +The files inside the *DISPLAY* directory can be visualize 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 + + + +[Welcome]: <http://www.lmgc.univ-montp2.fr/~dubois/LMGC90/Web/Welcome_!.html> +[pre_lmgc]: <http://www.lmgc.univ-montp2.fr/%7Edubois/LMGC90/UserDoc/pre/index.html> +[chipy]: <http://www.lmgc.univ-montp2.fr/%7Edubois/LMGC90/UserDoc/chipy/index.html> +[LMGC90_Postpro.pdf]: <https://git-xen.lmgc.univ-montp2.fr/lmgc90/lmgc90_user/blob/2017.rc1/manuals/LMGC90_Postpro.pdf>