Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/benma/pysph
SPH fluid simulation with advanced screen space fluid rendering, using pyopengl and pyopencl.
https://github.com/benma/pysph
Last synced: 3 months ago
JSON representation
SPH fluid simulation with advanced screen space fluid rendering, using pyopengl and pyopencl.
- Host: GitHub
- URL: https://github.com/benma/pysph
- Owner: benma
- Created: 2012-04-29T20:10:48.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2013-06-24T11:45:01.000Z (over 11 years ago)
- Last Synced: 2024-04-18T22:40:03.306Z (7 months ago)
- Language: Python
- Homepage:
- Size: 957 KB
- Stars: 106
- Watchers: 5
- Forks: 18
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-physics - pysph - SPH fluid simulation with advanced screen space fluid rendering, using pyopengl and pyopencl (Mechanics / Fluid Mechanics)
README
#pysph
pysph is a demo of:
* sph (smooth particle hydrodynamics) fluid simulation
* screen space fluid rendering, based on Simon Green's paper [Screen Space Fluid Rendering with Curvature Flow](http://www.cs.rug.nl/~roe/publications/fluidcurvature.pdf).
* how to use Python for these kind of things using the excellent pyopengl and pyopencl libraries.
* how to make and use bindings to the Cg runtime libraries in Python.
Also contained are ports of radix sort and bitonic sort to pyopencl. Based on [enjalot's work](https://github.com/enjalot/adventures_in_opencl/tree/master/experiments).
Big thanks to Ian Johnson (enjalot) for the radix/bitonic sort and his excellent tutorial: "[Adventures in PyOpenCL](http://enja.org/2011/02/22/adventures-in-pyopencl-part-1-getting-started-with-python/)".
## Running:
Run with `python main.py [number of particles]`. Start with `python main.py 8000` and slowly scale the number of particles up.
You can disable the advanced rendering by using `python main.py --disable-advanced-rendering [number of particles]`.
For more options, run `python main.py --help`.
## Dependencies
**On Debian Testing (sid):**
`sudo apt-get install python-opengl python-pyside nvidia-cg-toolkit python-numpy python-mako python-pyopencl`
And either package providing pyopencl-icd: nvidia-opencl-icd for nvidia users, amd-opencl-icd for ati users.
**On Ubuntu:**
`sudo apt-get install python-opengl python-pyside nvidia-cg-toolkit python-numpy python-mako`
Unfortunately on Ubuntu (up to 12.04), the package python-pyopencl is outdated and is missing the --cl-enable-gl flag.
Using pip also won't work, because it does not configure the package using the --cl-enable-gl flag.
You will need to follow the official build instructions here: http://wiki.tiker.net/PyOpenCL/Installation/Linux/Ubuntu.
If you want to isolate the installation of pyopencl, you can still install it in a virtualenv by using:
```
$ virtualenv --system-site-packages pysph_env
$ source pysph_env/bin/activate
$ git clone http://git.tiker.net/trees/pyopencl.git
$ cd pyopencl/
$ python ./configure.py --cl-enable-gl
$ python setup.py build
$ python setup.py install --prefix=/path/to/pysph_env/ --optimize=1
$ python /path/to/pysph/main.py
```
**On Windows**
* [pyopencl build instructions](http://wiki.tiker.net/PyOpenCL/Installation/Windows).
* [PySide](http://qt-project.org/wiki/PySide_Binaries_Windows)
## Limitations
Screen space rendering is not complete. It is not optimized for speed.
Also, the rendering at the boundaries is not properly dealt with yet, you can see the artefacts in the screenshots.
The program crashes when using an **AMD card**. I welcome pull requests from AMD users.