© [2025] Ubisoft Entertainment. All Rights Reserved

Hierarchical Differentiable Fluid Simulation

Xiangyu Kong ([email protected]), Arnaud Schoentgen, Damien Rioux-Lavoie, Paul G. Kry, Derek Nowrouzezahrai.

See our project page TODO and GitHub Repo.

Getting Started

Requirements

1. The project was developed with Python 3.12.4 and managed through Miniforge

2. CUDA Toolkit version 12.9

3. See requirement.txt for the list of dependencies.

   pip3 install -r requirements.txt

4. (Optional) OpenVDB Python bindings are used for exporting and importing the simulation results into Houdini for render, but are not necessary for running the code.

Project Structure

All simulation code is in the src/diffsim package, and split into 2D and 3D implementations. A simple example of a 3D simulation can be run in src/diffsim/simulation.py.

Experiments in the paper are implemented in the src/experiments package with self-explanatory names. Each file can be run independently, and the results will be saved in the out folder.

Citation

Please cite our work if you find it useful:

@article{hierarchicalDiffFluid,
    author = {Kong, Xiangyu and Schoentgen, Arnaud and Rioux-Lavoie, Damien and Kry, Paul G. and Nowrouzezahrai, Derek},
    title = {Hierarchical Differentiable Fluid Simulation},
    journal = {Computer Graphics Forum},
    volume = {n/a},
    number = {n/a},
    pages = {e70226},
    keywords = {differentiable fluid simulation, fluid control, fluid simulation},
    doi = {https://doi.org/10.1111/cgf.70226},
    url = {https://onlinelibrary.wiley.com/doi/abs/10.1111/cgf.70226},
    eprint = {https://onlinelibrary.wiley.com/doi/pdf/10.1111/cgf.70226},
}

© [2025] Ubisoft Entertainment. All Rights Reserved