This version is meant to be used with TFEL Version 5.2.

Known incompatibilities

Documentation

New cmake options

Support for CUDA in MGIS/Function

Support for CUDA in MGIS/Function is enable by enable-cuda-algorithms.

HDF5 support

The following options control the support of the HDF5 library:

Doxygen documentation

The doxygen documentation is now online: https://thelfer.github.io/mgis/doxygen/index.html.

New features

Scripts to define environment variables for MGIS to work properly

Depending on the system and compilation options, some of following variables shall be set for MGIS to work properly: MGISHOME, PATH, LD_LIBRARY_PATH and PYTHONPATH.

MGIS now installs automatically the following files in the installation directory (refered to <install_prefix> in the following):

Note

Those variables are not required if MGIS is installed system-wide (for instance in /usr/local) and that the MGIS’s binaries are not relocated (i.e. moved to a different directory than the one specified during the compilation process as the installation directory).

Note

If MGIS is built with TFEL support, the TFEL environment shall be properly set.

New features of the MGIS/Behaviour library

Save/restore operations in MaterialStateManager and MaterialDataManager

If HDF5 support is enabled, two functions save and restore are available:

Those functions have options allowing to precisely select what is saved or restored.

By default, one expects to restore the maximum amount of information. The getGreedyMaterialStateManagerRestoreOptions function creates option that can restore everything that has been saved.

Control on variables updated/reverted in MaterialStateManager

By default, material properties, mass density and external state variables are updated by the update and revert functions.

This can now be controlled by passing a value of the MaterialStateManager::UpdatePolicy type to the functions setMaterialProperty, setMassDensity or setExternalStateVariable.

Example of usage

setExternalStateVariable(m.s1, "Temperature", T1,
                         MaterialStateManager::UPDATE);

New features of the MGIS/Function library

Support for quantities

Quantities is features of the TFEL/Math library which allows assigning an unit to a floating point number.

MGIS/Function provides as_qt to turn a function into a view returning quantities. Tensor modifiers, such as as_stensor now allows to specify a quantity as an optional argument.

Example of usage

~~{.c++} // make a view of a scalar function which returns a stress value auto s = f | as_qt; // make a view of the function return a symmetric tensor in 2D whose values are stress auto s = f2 | as_stensor<2u, stress>;~~

Functions using a strided memory access

The following classes have been introduced:

StridedCoalescedMemoryAccessTensorView

StridedCoalescedMemoryAccessTensorView is a tensorial function view which stores its components in non interleaved manner using the following scheme:

| <------- Component 1 ---------> |....| <----- Component Nc ---------> |
+-------++-------++------++-------+----+-------++------++------++-------+
| Elt 1 || Elt 2 || .... || Elt N |....| Elt 1 ||Elt 2 || .... || Elt N |
+-------++-------++------++-------+----+-------++------++------++-------+

Example of usage

constexpr auto ne = size_type{2};
auto space = BasicLinearSpace{ne};
std::array<const real, 4 * ne> values = {1, 10, 2, 20, 3, 30, 4, 40};
const auto f = StridedCoalescedMemoryAccessTensorView<
    BasicLinearSpace, tfel::math::stensor<2, real>, false>{space, values};
const auto e1 = f(0);
// e1 = {1, 2, 3, 4}
const auto e2 = f(1);
// e2 = {10, 20, 30, 40}

StridedCoalescedMemoryAccessCompositeTensorsView

StridedCoalescedMemoryAccessCompositeTensorsView allows retrieving scalar or tensorial objects which are stored in a non interleaved manner.

Example of usage

using CompositeFunctionView = 
    StridedCoalescedMemoryAccessCompositeTensorsView<BasicLinearSpace, 4,
                                                     false>;
constexpr auto ne = size_type{2};
auto space = BasicLinearSpace{ne};
std::array<const real, 4 * ne> values = {1, 10, 2, 20, 3, 30, 4, 40};
const auto f = CompositeFunctionView{space, values};
const auto e1 = f.get<0, tfel::math::stensor<2, real>>(0);
// e1 = {1, 2, 3, 4}
const auto e2 = f.get<0, tfel::math::stensor<2, real>>(1);
// e2 = {10, 20, 30, 40}

Allow modifiers to handle temporary views

In Version 3.1, passing a temporary view to a modifier would create an evaluator. This behaviour was due to the fact that:

In Version 3.2, modifiers are now allowed to operate on temporary views. This following code now generates a view rather than an evaluator:

// creating an array view from an rvalue.
auto v = f.view() | as_array<2>;

By comparison, to achieve the same behaviour in Version 3.1, creation of an intermediate variable was required, as follows:

// creating an array view in Version 3.1:
auto f_view = f.view();
auto v = f_view | as_array<2>;

Temporary views can be used in “assignement” operator| and assign function

In Version 3.1, “assignement” operator| and assign function did not accept temporaries.

This behaviour has been changed in Version 3.2 which allows a more direct code:

f2 | as_scalar | (f | as_scalar); // "assignement" operator|

or equivalently:

assign(ctx, f | as_scalar, f2 | as_scalar);

By comparison, Version 3.1 would have forced to store the view resulting from f | as_scalar into a temporary as follows:

auto tmp = f | as_scalar;
assign(ctx, tmp, f2 | as_scalar);

Issues fixed

Issue 255: Fix InvokeTest on MacOS

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/255

Issue 250: Add ErrorBacktrace::assertOrTerminate

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/250

Issue 248: Add ErrorBacktrace::terminate

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/248

Issue 245: Add an overload of isInvalid for taking an InvalidResult as argument

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/245

Issue 244: Avoid repeating Context object in construct, make_unique or make_shared (and siblings) when the constructor takes a Context as first argument`

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/244

Issue 236: [mgis-function] Allow “assignement” operator | and assign algorithm to work on temporary views



For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/236

Issue #233: [cmake] Add a build-tests target

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/233

Issue 232: [mgis-function] add more constraint on the assign algorithm to detect if values of the function can be assigned to the values of the evaluator

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/232

Issue 227: [mgis-function] allow modifiers and views to take lightweigh functions views by copy, i.e. alleviate restrictions that views and modifiers can’t operate on temporaries

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/227

Issue 226: [mgis-function] make assign_value extensible to support external types

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/226

Issue 220: [mgis-function] Add support for nvcc

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/220

Issue 210: documentation Deployment of the doxygen documentation

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/210

Issue 209: Add basic support for save/restore operations in MaterialDataManager

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/209

Issue 201: Add the ability to update only the state variables of a MaterialStateManager

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/201

Issue 200: Create environment file in the installation directory

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/200

Issue 199: [mgis-function] add support for TFEL/Math’s quantities

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/199

Issue 196: [MGIS/Function] Add function view with strided coalesent memory access

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/196

Issue 158: Model implicite for LICOS software

For more details, see https://github.com/thelfer/MFrontGenericInterfaceSupport/issues/158

Acknowledgements

The authors are grateful to the many contributors to the TFEL/MFront project. This research was conducted in the framework of the PLEIADES project, which was supported financially by the CEA (Commissariat à l’Énergie Atomique et aux Énergies Alternatives), EDF (Électricité de France) and Framatome. Work on MGIS/Function was performed as part of the EURATOM OperaHPC Project co-funded by the European Union.