Quick Start (no-download option)

If you want to perform black hole collision simulations right now, no download or installation is necessary! You can run your own black hole collision simulations from within your web browser! Here's how:

  1. Open the Interactive NRPy+ Tutorial (it might take a minute to load), hosted by the mybinder cloud.
  2. Click the "Colliding Black Holes!" module near the bottom (in purple).
  3. Click the "Fast-forward" button at the top, and then "Restart and Run All Cells". NRPy+ will first generate Einstein's equations of general relativity in the form of a highly optimized C code. Then the C code will be compiled into an executable and run on the cloud server. Finally, matplotlib is used within the notebook to visualize the output. The whole process takes about 10 minutes, but the movie near the bottom visualizes what just happened (reproducing what is on the homepage)
  4. If you want to fiddle with the black hole parameters, you can for example change the masses of the black holes by editing the line of code
    const REAL BH1_mass = 0.5,BH2_mass = 0.5;
    to whatever you like, and then returning to Step 3 above. It is most useful if the black holes' masses add up to 1. If you are interested in more details, they are all documented in previous NRPy+ tutorial modules.

While the above provides a playground for black hole simulations run in the cloud, the BlackHoles@Home BOINC client (which will enable you to benefit gravitational wave astronomy with your spare CPU cycles) is under development. Please sign up for the newsletter to stay apprised of the latest progress. We'll need your help when the time comes!

BlackHoles@Home is an open-source software project, hosted on github, and based on NRPy+/SymPy. NRPy+ is developed and documented in a series of Python-based Jupyter notebooks, using best-practices (including continuous integration). If you are a software developer or computational scientist interested in contributing to the project, please contact the lead developer. If you want to run this locally on your desktop, you might find the Anaconda distribution useful (though I just use a virtualenv with the PyPy interpreter). Download links are below.

Slow Start (run entirely on your own computer; you'll need to get Jupyter up and running on your computer before this works!):

Latest version of NRPy+ code, the code at the heart of BlackHoles@Home. Includes interactive NRPy+ tutorial Jupyter notebooks.

Ancient software:

Old (SENR/NRPy+) software repository.

All codes are licensed under the 2-clause BSD license unless otherwise specified.

Email Z. Etienne if you are interested in joining our development effort!