Skip to content
N-body and hydro analysis tools for python 2 and 3
Python C C++
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea Add ramses-RT support Nov 30, 2015
docs Update to version 0.48 May 5, 2019
pynbody Merge pull request #556 from pynbody/fix-subfind-order Apr 4, 2020
.gitignore setup: specify dependencies Jul 24, 2018
.travis.yml Remove use of StopIteration which breaks in Python 3.7 Dec 10, 2018 Update README for code acknowledgment clarity Aug 2, 2018
pyproject.toml setup: specify dependencies Jul 24, 2018 Final fix to import issues Jan 9, 2020


Build Status

Pynbody is a light-weight, portable, format-transparent analysis framework for N-body and hydrodynamic astrophysical simulations supporting PKDGRAV/Gasoline, Gadget, N-Chilada, and RAMSES AMR outputs.

Written in python, the core tools are accompanied by a library of publication-level analysis routines. For a quick tour of some of the features, have a look at this IPython notebook.

Getting started

If your python with distutils is installed and properly configured, you can simply do:

$ git clone
$ cd pynbody
$ python install
$ cd ..
$ python
>>> import pynbody

If this fails, you may need some more detailed installation instructions. Once you have the package instlaled, try the introductory tutorials. The full documentation can be found here.


Help us make pynbody better! As you develop analysis for your science with pynbody, consider making your code available for everyone else to use. You can do this by creating a tutorial or cookbook or by adding your code to the relevant sub-module and submitting a pull request (make a fork first -- see

Acknowledging the code

When using pynbody, please acknowledge it by citing the Astrophysics Source Code Library entry. Optionally you can also cite the Zenodo DOI for the specific version of pynbody that you are using (since 0.45), which may be found here.

Support and Contact

If you have trouble with Pynbody or you have feature requests/suggestions you can submit an issue, and/or shoot us an email on the Usergroup mailing list.

You can’t perform that action at this time.