yunoshev/py-sphviewer

Py-SPHViewer is a framework for rendering cosmological simulations in Python using the Smoothed Particle Hydrodynamics (or SPH for short) interpolation scheme.

py-sphviewer

Py-SPHViewer is a publicly available Python package to visualize and explore N-body + Hidrodynamical simulations. The Smoothed Particle Hydrodynamics interpolation scheme is used to interpolate the underlaying density field (or any other property) traced by a finite set of particles, t hus producing smooth images of a particle distribution that can be easily interpreted. It does also provide the natural way for visualizing in a self-consistent way gas dynamical simulations in which the same technique is used to compute the particle interactions.

Part of the code is written in C, but it can be used interactively from Python, using tools such as Ipython or Ipython notebook. It does not only smooth the properties of particles over a ceratin influence domain, but also allows to explore the simulated volumes using different projections.

I usually try to keep the latest (stable or not) version available in the Python Package Index (or Pypi for short), so that you can get it just doing:

pip install py-sphviewer 

or:

easy_install py-sphviewer 

Note that as far as you have not root permissions, the --user flag would be requiered.

In case you may want to clone and install by yourself the package from this repository, you can simply do:

git clone https://github.com/alejandrobll/py-sphviewer.git
cd py-sphviewer
python setup.py install

Perhaps a good example of the current power of Py-SPHViewer is the logo of the project,

The image above shows the dark matter distribution colored according to the velocity dispersion of a small halo taken from a cosmological simulation. It was rendered (of course) with Py-SPHViewer

More examples of the power of Py-SPHViewer are the following movies:

or,

and,

Previous movies show a 3D rotation around a dark matter halo taken from a cosmological simulation and the "Cosmic Web Stripping" process, which arise from hydrodynamical interaction betweet the gas content of dwarf galaxies and the large-scale structure of the Universe, respectively

Code Licence

Py-SPHViewer is under GNU GPL v3 licence, and was started by Alejandro Benitez-Llambay. It is under development and changes everytime. It's your responsibility to be aware of the changes and to check the code for understanding what it does.

Basic Tutorial

If you are interested in using Py-SPHVIewer, you should take a look at the very little tutorial. This tutorial assumes that you are familiar with Python. If not, please go to learn Python and come back.

Citing the code

If Py-SPHViewer has been significant in your project and leads to a publication, please acknowledge by citing the project. You can check the DOI at Zenodo: , or just use the following BibTex:

@misc{alejandro_benitez_llambay_2015_21703,
author       = {Alejandro Benitez-Llambay},
title        = {py-sphviewer: Py-SPHViewer v1.0.0},
month        = jul,
year         = 2015,
doi          = {10.5281/zenodo.21703},
url          = {http://dx.doi.org/10.5281/zenodo.21703}
}

or in plain text:

Alejandro Benitez-Llambay. (2015). py-sphviewer: Py-SPHViewer v1.0.0. Zenodo. 10.5281/zenodo.21703