You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
cflin bdcbf80490 add error tip 2 years ago
assets add single_color_model; colormap_model 2 years ago
cmake initialize 2 years ago
comparisons add single_color_model; colormap_model 2 years ago
docs/imgs initialize 2 years ago
engine finished error compare 2 years ago
fixtures initialize 2 years ago
meshes initialize 2 years ago
notebooks initialize 2 years ago
python initialize 2 years ago
sim-test/rigid-test reduce engine.json.in && add save OBJ button 2 years ago
src add error tip 2 years ago
static_sim add single_color_model; colormap_model 2 years ago
tests initialize 2 years ago
tools initialize 2 years ago
.gitignore add single_color_model; colormap_model 2 years ago
CMakeLists.txt rm trival menu 2 years ago
Doxyfile initialize 2 years ago
LICENSE initialize 2 years ago
README.md initialize 2 years ago
README_USAGE.md add error tip 2 years ago
setup.py initialize 2 years ago

README.md

Rigid IPC

Build License

Robust, intersection-free, simulations of rigid bodies.

This is the open-source reference implementation of the SIGGRAPH 2021 paper Intersection-free Rigid Body Dynamics.

Files

  • src/: source code
  • cmake/ and CMakeLists.txt: CMake files
  • fixtures/: input scripts to rerun all examples in our paper
  • meshes/: input meshes used by the fixtures
  • tests/: unit-tests
  • tools/: Python and Bash scripts for generating and processing results
  • comparisons/: files used in comparisons with other rigid body simulators
  • python/: Python binding files
  • notebooks/: Jupyter notebooks

Build

To build the project, use the following commands from the root directory of the project:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j4

Dependencies

All dependancies are downloaded through CMake depending on the build options. The following libraries are used in this project:

  • IPC Toolkit: common IPC functions
  • Eigen: linear algebra
  • libigl: basic geometry functions, predicates, and viewer
  • TBB: parallelization
  • Tight Inclusion CCD: correct (conservative) continuous collision detection between triangle meshes in 3D
  • spdlog: logging information
  • filib: interval arithmetic
  • Niels Lohmann's JSON: parsing input JSON scenes
  • tinygltf: exporting simulation animation to GLTF format
  • finite-diff: finite difference comparisons
    • Only used by the unit tests and when RIGID_IPC_WITH_DERIVATIVE_CHECK=ON

Optional

Scenes

We take as input a single JSON file that specifies the mesh and initial conditions for each body. The fixtures directory contains example scenes.

Python Bindings

We expose some functionality of Rigid IPC through Python. This is still in development and lacks the ability to script many features available in the full simulator.

To build the Python bindings use the setup.py script:

python setup.py install