Registry / data / pysplashsurf

pysplashsurf

library0.14.1.0pypypi✓ verified 82d ago

Python bindings for splashsurf, a high-performance surface reconstruction library for SPH (Smoothed Particle Hydrodynamics) simulations. Current version 0.14.1.0, release cadence irregular; follows the underlying C++ library.

data

pip install pysplashsurf

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · PYSPLASHSURF

pysplashsurf

datapythonv0.14.1.0

Install

3.8s avg

Import

—

Disk

94MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.14.1.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.8s · import 0.000s · 93MB

94MB installed

● package 94MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SurfaceReconstruction

✓ from pysplashsurf import SurfaceReconstruction

✗ from splashsurf import reconstruct_surface

reconstruct_surface

✓ from pysplashsurf import SurfaceReconstruction

✗ from splashsurf import reconstruct_surface

marching_cubes

✓ from pysplashsurf import marching_cubes

✗ from splashsurf import reconstruct_surface

Basic surface reconstruction from particle positions.

import numpy as np from splashsurf import reconstruct_surface # Example: random particle positions positions = np.random.rand(1000, 3).astype(np.float64) # Reconstruct surface (returns vertices, faces as numpy arrays) vertices, faces = reconstruct_surface(positions) print(f"Surface: {len(vertices)} vertices, {len(faces)} faces")

Debug

Known issues

breakingThe Python API changed between version 0.11.x and 0.12.x: the function `reconstruct_surface` now returns a tuple `(vertices, faces)` instead of a namedtuple-like object. Old code using attribute access will break.

fix

Update code to unpack the tuple: `vertices, faces = reconstruct_surface(positions)`.

affects: >=0.12.0

gotchaInput particle positions must be a contiguous numpy array of dtype float64 (double precision). Using float32 or non-contiguous arrays (e.g., slices) may cause segmentation faults or incorrect results.

fix

Ensure positions are `np.ascontiguousarray(positions, dtype=np.float64)`.

affects: all

gotchaOn macOS with Apple Silicon, the pip-installed wheel may fall back to a slow pure-Python fallback if the native binary is not available. Install from conda-forge or build from source for optimal performance.

fix

Use `conda install -c conda-forge pysplashsurf` or build from source following the GitHub instructions.

affects: all

Upgrade

Version history

0.14.1.0latest on PyPI · released Mar 21, 2026

Audit

Dependencies

numpyrequiredInput/output particle positions and mesh arrays

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/InteractiveComputerGraphics/splashsurf.git ↗

packagehttps://pypi.org/project/pysplashsurf/ ↗

homepagehttps://splashsurf.physics-simulation.org/ ↗

docshttps://pysplashsurf.readthedocs.io/ ↗