starlab_physics's Introduction

XPBD Cloth Simulation

Environment

Install

pip install -r requirements.txt

Current Features

XPBD
- Constraints
  - Spring Constraints
  - Bending Constraints
  - Non-penetration Constraints
- Solver
  - Jacobi
  - [WIP] Parallel Gauss-Seidel
Collision detection
- Broad phase
  - Parallel AABB BVH Construction/Traversal
  - Spatial Hashing
- Narrow phase
  - Vertex-Triangle
  - [WIP] Edge-Edge
Utilities
- GUI for setting XPBD parameters in runtime
- Vertex selection (for setting fixed)
- Exporting simulated meshes

run demo

python main.py

Frequently used keys

'r' : reset simulation
' ' : run/stop simulation

Changing the simulation mesh

The mesh data(i.e., *.obj) are in the "starlab_physics/models/OBJ" folder.

In "starlab_physics/Scenes/concat_test.py" file,

model_dir = str(model_path / "OBJ")
model_names = []
trans_list = []
scale_list = []

...

offsets = concat_mesh(concat_model_name, model_dir, model_names, trans_list, scale_list)

fill in ... with your mesh data, as follows:

model_names.append("your-obj-name.obj")
trans_list.append([x, y, z])
scale_list.append(size)

References

Lauterbach, Christian, et al. "Fast BVH construction on GPUs." Computer Graphics Forum. Vol. 28. No. 2. Oxford, UK: Blackwell Publishing Ltd, 2009.
Macklin, Miles, Matthias Müller, and Nuttapong Chentanez. "XPBD: position-based simulation of compliant constrained dynamics." Proceedings of the 9th International Conference on Motion in Games. 2016. 3Lauterbach, Christian, et al. "Fast BVH construction on GPUs." Computer Graphics Forum. Vol. 28. No. 2. Oxford, UK: Blackwell Publishing Ltd, 2009.

starlab_physics's People