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)