Get the code!

Python code to evaluate gravitational waveform surrogate models trained on waveform data generated by point-particle black hole perturbation theory.

EMRI surrogate

Model Details

The EMRISurrogate package provides access to a surrogate gravitational waveform model. Currently, this package supports one model, EMRISur1dq1e4, for non-spinning black hole binary systems with mass-ratios varying from 3 to $10^4$. The “raw” surrogate model is trained on waveform data generated by point-particle black hole perturbation theory (ppBHPT) and defined as, where $^{-2}Y_{\ell m}$ are the spin$=-2$ weighted spherical harmonics. The surrogate model provides fast evaluations for the modes, $h_{\tt S}^{\ell,m}$. Available modes are,

while the $m<0$ modes $h^{\ell, -m} = (-1)^{\ell} h^{\ell,m}{}^*$ can be deduced from the $m>0$ modes.

By default, the EMRISurrogate package will return rescaled waveform modes, where the total mass rescaling parameter, $\alpha(q)$, is tuned to NR simulations. We expect most users of this package will want the NR-tuned model. To generate point-particle perturbation theory waveforms without any tuning to NR set $\alpha = 1$ in the function slog_surrogate.

Model details can be found in paper 1 (see citations below).

Getting the code

The latest development version will always be available from the project git repository:

git clone https://github.com/BlackHolePerturbationToolkit/EMRISurrogate.git

Requirements, Installation, and Usage

For details on these topics check out the README and the Jupyter notebook.

Known problems

Known bugs are recorded in the project bug tracker


This code is distributed under the MIT License. Details can be found in the LICENSE file.


Scott Field, Tousif Islam, Gaurav Khanna, Nur Rifat, Vijay Varma

Citation guideline

If you make use of any module from the Toolkit in your research please acknowledge using “This work makes use of the Black Hole Perturbation Toolkit”. If you make use of the EMRI surrogate model, EMRISur1dq1e4, please cite Paper 1:

  title={A Surrogate Model for Gravitational Wave Signals from Comparable-to Large-Mass-Ratio Black Hole Binaries},
  author={Rifat, Nur EM and Field, Scott E and Khanna, Gaurav and Varma, Vijay},
  journal={arXiv preprint arXiv:1910.10473},