Mixed Variational Finite Elements for Implicit Simulation of Deformables

Open-source reference implementation of Mixed Variational Finite Elements for Implicit Simulation of Deformables

Files

• apps/: cpp executables
• cmake/: CMake files
• deps/: dependencies
• models/: input meshes
• scenes/: json scripts for different examples
• scripts/: miscellaneous matlab scripts
• src/: source code
• tests/: unit-tests (they all fucked right now)

To download and build

git clone --recurse-submodules https://github.com/tytrusty/mfem.git
cd mfem
mkdir build
cd build
cmake ..
make -j4

Usage

There are two simulation executables for 2D and 3D simulation, which in the build directory will be bin/sim2d and bin/sim3d. These executables a scene JSON file, which we include examples of in the scenes directory.

For example from your build directory try executing:

./bin/sim2d ../scenes/2D/square.json

or for a 3D example

./bin/sim3d ../scenes/3D/boat.json

After launching the application, you can use the GUI to start/stop/reset the simulation as well as modify many of the parameters. Currently there is no headless version since I think the GUI is much more fun :).

Dependencies

This project depends on the following libraries

• Eigen: linear algebra
• libigl: geometry processing
• Bartels: physics (don't think i neeed this anymore)
• polyscope: GUI

If unit tests are enabled:

• finite-diff: finite difference used in unit tests
• Catch2: unit testing framework

Python Bindings

Coming sort of soon (not that soon)