pysplishsplash
SPlisHSPlasH is an open-source library for the physically-based simulation of fluids.
Science Score: 62.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
5 of 12 committers (41.7%) from academic institutions -
✓Institutional organization owner
Organization interactivecomputergraphics has institutional domain (animation.rwth-aachen.de) -
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (10.4%) to scientific vocabulary
Keywords
Repository
SPlisHSPlasH is an open-source library for the physically-based simulation of fluids.
Basic Info
- Host: GitHub
- Owner: InteractiveComputerGraphics
- License: mit
- Language: C++
- Default Branch: master
- Homepage: https://splishsplash.physics-simulation.org/
- Size: 17.2 MB
Statistics
- Stars: 1,743
- Watchers: 70
- Forks: 309
- Open Issues: 15
- Releases: 21
Topics
Metadata Files
README.md
SPlisHSPlasH is an open-source library for the physically-based simulation of fluids. The simulation in this library is based on the Smoothed Particle Hydrodynamics (SPH) method which is a popular meshless Lagrangian approach to simulate complex fluid effects. The SPH formalism allows an efficient computation of a certain quantity of a fluid particle by considering only a finite set of neighboring particles. One of the most important research topics in the field of SPH methods is the simulation of incompressible fluids. SPlisHSPlasH implements current state-of-the-art pressure solvers (WCSPH, PCISPH, PBF, IISPH, DFSPH, PF) to simulate incompressibility. Moreover, the library provides different methods to simulate viscosity, surface tension and vorticity.
The library uses the following external libraries: Eigen, json, partio, zlib, cxxopts, tinyexpr, toojpeg, pybind, glfw, hapPLY, nfd, and imgui. All external dependencies are included.
Furthermore we use our own libraries: - PositionBasedDynamics to simulate dynamic rigid bodies - Discregrid to detect collisions between rigid bodies - CompactNSearch to perform the neighborhood search - cuNSearch to perform the neighborhood search on the GPU - GenericParameters to handle generic parameters
SPlisHSPlasH can export the particle data in the partio and vtk format. If you want to import partio files in Maya or Blender, try out our plugins: - Blender Sequence Loader - MayaPartioTools
Author: Jan Bender
License
The SPlisHSPlasH library code is licensed under the MIT license. See LICENSE for details.
External dependencies are covered by separate licensing terms. See the extern folder for the code and respective licensing terms of each dependency.
Documentation
Forum
On our GitHub discussions page you can ask questions, discuss about simulation topics, and share ideas.
Build Instructions
This project is based on CMake. Simply generate project, Makefiles, etc. using CMake and compile the project with a compiler of your choice that supports C++11. The code was tested with the following configurations: - Windows 10 64-bit, CMake 3.18.3, Visual Studio 2019 - Debian 11.5 64-bit, CMake 3.18.4, GCC 10.2.1.
Note: Please use a 64-bit target on a 64-bit operating system. 32-bit builds on a 64-bit OS are not supported.
Python Installation Instruction
For Windows and Linux targets there exists prebuilt python wheel files which can be installed using
pip install pysplishsplash
These are available for Python versions 3.6-3.10. See also here: pySPlisHSPlasH.
If you do not meet these conditions please refer to the build instructions and to the python binding
Getting started guide.
The command line simulator is available by running one of the following
splash
splash --help
Features
SPlisHSPlasH implements: * an open-source SPH fluid simulation (2D & 3D) * neighborhood search on CPU or GPU * supports vectorization using AVX * Python binding (thanks to Stefan Jeske) * supports embedded Python scripts * several implicit pressure solvers (WCSPH, PCISPH, PBF, IISPH, DFSPH, PF) * explicit and implicit viscosity methods * current surface tension approaches * different vorticity methods * computation of drag forces * support for multi-phase simulations * simulation of deformable solids * rigid-fluid coupling with static and dynamic bodies * two-way coupling with deformable solids * XSPH velocity filter * fluid emitters * scripted animation fields * a json-based scene file importer * automatic surface sampling * a tool for volume sampling of closed geometries * a tool to generate spray, foam and bubble particles in a postprocessing step * a tool to skin a visual mesh to the moving particles of an elastic solid in a postprocessing step * partio file export of all particle data * VTK file export of all particle data (enables the data import in ParaView) * rigid body export * a Maya plugin to model and generate scene files * a ParaView plugin to import particle data
A list of all implemented simulation methods can be found here: https://splishsplash.physics-simulation.org/features
Screenshots & Videos
https://splishsplash.physics-simulation.org/gallery
Citation
To cite SPlisHSPlasH you can use this BibTeX entry:
bibtex
@software{SPlisHSPlasH_Library,
author = {Bender, Jan and others},
license = {MIT},
title = {{SPlisHSPlasH Library}},
url = {https://github.com/InteractiveComputerGraphics/SPlisHSPlasH},
}
Owner
- Name: Interactive Computer Graphics
- Login: InteractiveComputerGraphics
- Kind: organization
- Location: Germany
- Website: https://animation.rwth-aachen.de/
- Repositories: 12
- Profile: https://github.com/InteractiveComputerGraphics
Citation (CITATION.cff)
cff-version: 1.2.0
title: SPlisHSPlasH Library
message: >-
If you use this software, please cite it using the
metadata from this file.
type: software
authors:
- given-names: Jan
family-names: Bender
- family-names: others
identifiers:
- type: url
value: >-
https://github.com/InteractiveComputerGraphics/SPlisHSPlasH
repository-code: >-
https://github.com/InteractiveComputerGraphics/SPlisHSPlasH
keywords:
- Smoothed Particle Hydrodynamics
- SPH
- fluids
- simulation
license: MIT
GitHub Events
Total
- Issues event: 10
- Watch event: 154
- Delete event: 1
- Issue comment event: 10
- Push event: 11
- Pull request event: 7
- Pull request review event: 3
- Fork event: 23
Last Year
- Issues event: 10
- Watch event: 154
- Delete event: 1
- Issue comment event: 10
- Push event: 11
- Pull request event: 7
- Pull request review event: 3
- Fork event: 23
Committers
Last synced: 9 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Jan Bender | b****r@c****e | 156 |
| Stefan Jeske | s****e@r****e | 33 |
| Marcel Weiler | w****r@g****e | 20 |
| Marcel | m****l@c****u | 2 |
| Nico Zevallos | g****t@g****m | 2 |
| judgebc | j****n@b****m | 1 |
| Zhehao Li | 4****9 | 1 |
| Simon Altrogge | 8****e | 1 |
| Holger Götz | 1****e | 1 |
| weiler | M****r | 1 |
| Jan Bender | j****r@s****e | 1 |
| Christoph Gissler | g****r@f****u | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 123
- Total pull requests: 25
- Average time to close issues: 3 months
- Average time to close pull requests: 3 months
- Total issue authors: 80
- Total pull request authors: 13
- Average comments per issue: 2.06
- Average comments per pull request: 1.88
- Merged pull requests: 15
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 11
- Pull requests: 7
- Average time to close issues: about 16 hours
- Average time to close pull requests: 4 days
- Issue authors: 7
- Pull request authors: 4
- Average comments per issue: 0.0
- Average comments per pull request: 0.0
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- hosseinrezaa (13)
- chunleili (5)
- happtain (4)
- HanlinGao (3)
- Perpetual3134 (3)
- george-polevoy (3)
- BinglunWang (3)
- arjun-mani (3)
- Hassan-math (3)
- kyletreece (2)
- haipengyuan (2)
- uljadberdica1000 (2)
- cesss (2)
- liyunfei18 (2)
- ytimber (2)
Pull Request Authors
- digitalillusions (9)
- holgergoe (2)
- gileoo (2)
- npt-1707 (2)
- ruberith (2)
- zhehaoli1999 (1)
- simonaltrogge (1)
- RobBa (1)
- KritiaSthovania (1)
- janbender (1)
- yoony97 (1)
- Kilidsch (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 722 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 35
- Total maintainers: 1
pypi.org: pysplishsplash
SPlisHSPlasH Project Python Bindings
- Homepage: https://github.com/InteractiveComputerGraphics/SPlisHSPlasH
- Documentation: https://pysplishsplash.readthedocs.io/
- License: MIT
-
Latest release: 2.15.1
published 6 months ago
Rankings
Maintainers (1)
Dependencies
- docutils ==0.16
- exhale *
- recommonmark *
- sphinx ==4.2.0
- sphinxcontrib.bibtex <2.0.0
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/upload-artifact master composite
- digitalillusions/python-wheels-manylinux-build master composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/upload-artifact master composite
- numpy *