You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://github.com/InteractiveComputerGraphics/splashsurf)
[](https://github.com/InteractiveComputerGraphics/splashsurf/actions/workflows/build.yml)
Surface reconstruction library and CLI for particle data from SPH simulations, written in Rust.
7
11
8
12
---
9
-
**NEW**: The project now implements the paper ["Weighted Laplacian Smoothing for Surface Reconstruction of Particle-based Fluids" (Löschner, Böttcher, Jeske, Bender; 2023)](https://animation.rwth-aachen.de/publication/0583/).
13
+
14
+
## News
15
+
16
+
**2025-06-25**: We published Python bindings for the CLI of splashsurf and most library features 🐍! Pre-built wheels can be installed using PIP: `pip install pysplashsurf`. See the [PyPI entry of pySplashsurf](https://pypi.org/project/pysplashsurf) for more information.
17
+
18
+
**2023-09-25**: The project now implements the paper ["Weighted Laplacian Smoothing for Surface Reconstruction of Particle-based Fluids" (Löschner, Böttcher, Jeske, Bender; 2023)](https://animation.rwth-aachen.de/publication/0583/).
10
19
It proposes a fast smoothing approach to avoid the typical bumpiness of the surfaces reconstructed from SPH simulations while preventing loss of volume for splashes and droplets that occurs with simple, non-specialized smoothing methods.
11
20
The images below show a rendering of a typical surface reconstruction (on the left) with visible bumps due to the SPH particles compared to the same surface reconstruction with weighted smoothing applied (on the right):
12
21
@@ -18,10 +27,12 @@ You can see this rendering in motion in [this video](https://youtu.be/2bYvaUXlBQ
18
27
19
28
---
20
29
30
+
## About
21
31
22
32
This project consists of the following crates:
23
-
-`splashsurf`: Binary crate with a CLI (command line interface) to quickly run surface reconstructions of SPH particle data files from the terminal
24
-
-`splashsurf_lib`: Library that implements the reconstruction pipeline used by the CLI. Allows to integrate the reconstruction procedure directly into other Rust applications. Furthermore, it resembles a framework providing access to individual building blocks to create your own surface reconstruction pipeline.
33
+
- 🛠️ `splashsurf`: Binary crate with a CLI (command line interface) to quickly run surface reconstructions of SPH particle data files from the terminal. Install with `cargo install splashsurf`.
34
+
- 🧰 `splashsurf_lib`: Rust library that implements the reconstruction method used by the CLI. Allows integrating the reconstruction procedure directly into other Rust applications. Furthermore, it resembles a framework providing access to individual building blocks to create your own surface reconstruction pipeline.
35
+
- 🐍 `pysplashsurf`: Bindings to the CLI and library for Python. Install with `pip install splashsurf` and see the [`README`](pysplashsurf/README.md) for more details.
25
36
26
37
<palign="center">
27
38
<imgsrc="assets/example_particles.png"alt="Image of the original particle data"width="32%"> <imgsrc="assets/example_coarse.png"alt="Image of a coarse reconstructed surface mesh"width="32%"> <imgsrc="assets/example_fine.png"alt="Image of a fine reconstructed surface mesh"width="32%">
@@ -39,3 +50,12 @@ The result might look something like this:
39
50
<palign="center">
40
51
<imgsrc="assets/splashsurf.gif"alt="Rendered water animation"width="96%">
41
52
</p>
53
+
54
+
For more information please refer to the [GitHub repository of splashsurf](https://github.com/InteractiveComputerGraphics/splashsurf).
55
+
56
+
## Acknowledgements
57
+
58
+
This project contains notable contributions from the following people:
59
+
-[Timna Böttcher](https://animation.rwth-aachen.de/person/80/) ([@timnaboettcher](https://github.com/timnaboettcher)): co-developed the [weighted smoothing approach](https://diglib.eg.org/handle/10.2312/vmv20231245)
60
+
-[Felix Kern](https://github.com/Fek04) ([@Fek04](https://github.com/Fek04)): implemented the Python bindings for `splashsurf`
61
+
-[Fabian Löschner](https://www.floeschner.de/) ([@w1th0utnam3](https://github.com/w1th0utnam3)): implemented most of the surface reconstruction library and CLI including the domain decomposition
0 commit comments