The MGIS project

Author

Thomas Helfer

Date

28/01/2020

The official website of the MGIS project is the following: https://thelfer.github.io/mgis/web/index.html.

This project aims at proving tools (functions, classes, bindings, etc...) to handle behaviours written using MFront generic interface. For information about MFront, see http://tfel.sourceforge.net.

Those tools are meant to be used by (FEM, FFT, etc.) solver developers. This tools are not linked to the TFEL libraries. Permissive licences have been chosen to allow integration in open-source and proprietary codes.

The MFrontGenericInterface C++ library

The project is build around the MFrontGenericInterface library. This library provides two main functions:

• the mgis::behaviour::load functions loads MFront behaviours from external shared libraries and retrieve all relevant meta data function. Those relevant information are stored in the mgis::behaviour::Behaviour class.
• the mgis::behaviour::integrate integrates the behaviour over one time step. The data associated with an integration point are handled by the mgis::behaviour::BehaviourData class which contains the state of the integration point at the beginning and at the end of the time step.

The library also supports handling a group of integration points though the mgis::behaviour::MaterialStateManager class.

An introduction to the C++ library may be found here

Bindings

Existing bindings

The following bindings are available:

• c binding
• python binding
• fortran binding
• julia binding
• fenics bindings (experimental). Those bindings are strongly inspired by the fenics-solid-mechanics project. Those bindings are currently quite limited as mostly serve as a proof of concept. Note that MGIS can also be used in FEniCS through the python interface. This is discussed here.

Future bindings (contributors are welcomed)

The following bindings are under consideration:

• octave binding

Versions, branches

• Version 3.1.0 is meant to be build against TFEL 5.1
• Version 3.0.1 is meant to be build against TFEL 5.0.1
• Version 3.0 is meant to be build against TFEL 5.0
• Version 2.2.1 is meant to be build against TFEL 4.2.3
• Version 2.2 is meant to be build against TFEL 4.2
• Version 2.1 is meant to be build against TFEL 4.1
• Version 2.0 is meant to be build against TFEL 4.0
• Version 1.2.2 is meant to be build against TFEL 3.4.3
• Version 1.2.1 is meant to be build against TFEL 3.4.1
• Version 1.2 is meant to be build against TFEL 3.4.0
• Version 1.1 is meant to be build against TFEL 3.3.0
• Version 1.0 is meant to be build against TFEL 3.2.0
• Version 1.0.1 is meant to be build against TFEL 3.2.1

The following branches are available:

• The master branch follows the evolution of the master branch of the TFEL project
• The rliv-3.1 follows the evolution of the 5.1.x series of the TFEL project.
• The rliv-3.0 follows the evolution of the 5.0.x series of the TFEL project.
• The rliv-2.2 follows the evolution of the 4.2.x series of the TFEL project.
• The rliv-2.1 follows the evolution of the 4.1.x series of the TFEL project.
• The rliv-2.0 follows the evolution of the 4.0.x series of the TFEL project.
• The rliv-1.2 follows the evolution of the 3.4.x series of the TFEL project.
• The rliv-1.1 follows the evolution of the 3.3.x series of the TFEL project.
• The rliv-1.0 follows the evolution of the 3.2.x series of the TFEL project. Note that this branch is not compatible with TFEL-3.2.0.

Release notes

• Version 1.1

License

MGIS is published under the LGPLv3 licence.

Acknowledgement

This project uses code extracted from the following projects:

• https://github.com/bitwizeshift/string_view-standalone by Matthew Rodusek
• https://github.com/mpark/variant: by Michael Park
• https://github.com/progschj/ThreadPool by Jakob Progsch and Václav Zeman
• https://github.com/martinmoene/span-lite by Martin Moene
• https://github.com/jothepro/doxygen-awesome-css by jothepro