---
id: pysplashsurf
version: "0.14.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pysplashsurf — Python bindings for splashsurf, a surface reconstruction library for SPH simulations.

License: permissive · Maintenance: active · Downloads: 86.4K/mo

## What it is and what it does

pySplashsurf wraps the Rust-based splashsurf library to reconstruct 3D surfaces from particle data generated by SPH simulations. It takes a point cloud of particles and produces a mesh using marching cubes and related algorithms, with optional post-processing like smoothing and normal computation. The package works both as a Python library for programmatic use and as a command-line tool that mirrors the original splashsurf CLI.

The library depends only on numpy at runtime and optionally on meshio for file I/O beyond VTK format. It supports both single and double precision floats, and the prebuilt wheels cover most modern platforms. The reconstruction pipeline exposes parameters for particle radius, smoothing length, cube size, iso-surface threshold, and mesh cleanup options, making it suitable for scientific visualization and analysis of fluid dynamics simulations.

Use it for:

- Visualize fluid surfaces from SPH particle simulations by converting point clouds to renderable meshes
- Post-process particle data from computational fluid dynamics to extract surface geometry for further analysis
- Generate mesh representations of multiphase flow interfaces in scientific research workflows
- Batch-process simulation output files via the CLI to produce surface meshes with consistent parameters
- Integrate surface reconstruction into Python-based simulation pipelines for real-time or offline mesh generation

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pySplashsurf provides Python bindings for surface reconstruction from particle data in SPH (smoothed particle hydrodynamics) simulations, available as both a library and command-line tool.

Yes, if you work with SPH simulations or particle-based fluid data and need surface reconstruction. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and covers common platforms with prebuilt wheels. The medium install friction is reasonable for a compiled extension. Install with caution only if you are constrained to Python versions below 3.10.

## Install

pip install pysplashsurf
uv add pysplashsurf
poetry add pysplashsurf

## Installing pysplashsurf

Before you install: Medium install friction due to compiled Rust bindings, but prebuilt wheels cover common platforms (x86_64, ARM, Windows). Active maintenance with recent commits and no known vulnerabilities. Requires Python 3.10+.

License in practice: MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install pysplashsurf
import pysplashsurf
import numpy as np
particles = np.array([[0, 0, 0], [1, 1, 1]], dtype=np.float64)
mesh, reconstruction = pysplashsurf.reconstruction_pipeline(particles, particle_radius=0.025)

Requires Python 3.10 or later. Optional meshio dependency needed for write_to_file() and .bgeo file support.

Verify before relying:

- Performance characteristics (runtime, memory) for typical particle counts and grid resolutions
- Detailed comparison of reconstruction quality vs. other surface reconstruction libraries
- Stability and accuracy across different SPH simulation types and parameters

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 86.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

surface reconstruction SPH particles, marching cubes mesh generation, fluid simulation particle mesh, splashsurf python bindings, particle to mesh conversion, scientific mesh processing, physics simulation visualization, mesh-generation, sph-simulation, scientific-computing

[View on SkillFed](https://skillfed.io/packages/pysplashsurf) · [View on PyPI](https://pypi.org/project/pysplashsurf/)