pyseobnr

|pipeline status|

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black

pyseobnr provides state-of-the-art gravitational waveforms using the effective-one-body (EOB) approach.

For installation instructions, documentation, examples and more, visit the documentation here <https://waveforms.docs.ligo.org/software/pyseobnr/>__.

Installation

To install, you will need the following non-python dependencies:

• hdf5
• gsl>=2.7
• swig>=4.0.1
• fftw3
• lalsuite

The easiest way to get these is by using conda. First, create a new conda environment with

::

conda create -n pyseobnr python=3.9 conda activate pyseobnr conda install -c conda-forge lalsuite

You can install a released version of pyseobnr by running

::

pip install pyseobnr

If installing from source, you can do:

::

pip install -U pip wheel setuptools pip install .

Installing dependencies for checks

If one wants to run sanity checks in pyseobnr/auxiliary/sanity_checks additional dependencies must be installed. This can be done simply by running

::

pip install .[checks]

You will have to install the waveform_tools from here <https://bitbucket.org/sergei_ossokine/waveform_tools>__ manually though, with e.g. the following command

::

pip install git+https://bitbucket.org/sergei_ossokine/waveform_tools

License

pyseobnr is released under the GNU General Public License v3.0 or later, see here <https://choosealicense.com/licenses/gpl-3.0/>__ for a description of this license, or see the LICENSE <https://git.ligo.org/waveforms/software/pyseobnr/-/blob/main/LICENSE>__ file for the full text.

References

We request that any academic report, publication, or other academic disclosure of results derived from the use of pyseobnr acknowledge the use of the software by an appropriate acknowledgment or citation.

The code can be cited by citing the code repository <https://git.ligo.org/waveforms/software>_ and the associated publication: Mihaylov et al., "pySEOBNR: a software package for the next generation of effective-one-body multipolar waveform models", 2023, arXiv:2303.18203 <https://arxiv.org/abs/2303.18203>_. A bibtex entry is provided::

@article{Mihaylov:2023bkc,
    author = {Mihaylov, Deyan P. and Ossokine, Serguei and Buonanno, Alessandra and Estelles, Hector and Pompili, Lorenzo and P\"urrer, Michael and Ramos-Buades, Antoni},
    title = "{pySEOBNR: a software package for the next generation of effective-one-body multipolar waveform models}",
    eprint = "2303.18203",
    archivePrefix = "arXiv",
    primaryClass = "gr-qc",
    doi = "10.1016/j.softx.2025.102080",
    journal = "SoftwareX",
    volume = "30",
    pages = "102080",
    year = "2025"
}

In addition, if released models are used, the model papers should be cited:

• For SEOBNRv5PHM, Ramos-Buades et al., "SEOBNRv5PHM: Next generation of accurate and efficient multipolar precessing-spin effective-one-body waveforms for binary black holes", 2023, arXiv:2303.18046 <https://arxiv.org/abs/2303.18046>_::

  @article{Ramos-Buades:2023ehm, author = "Ramos-Buades, Antoni and Buonanno, Alessandra and Estell'es, H'ector and Khalil, Mohammed and Mihaylov, Deyan P. and Ossokine, Serguei and Pompili, Lorenzo and Shiferaw, Mahlet", title = "{Next generation of accurate and efficient multipolar precessing-spin effective-one-body waveforms for binary black holes}", eprint = "2303.18046", archivePrefix = "arXiv", primaryClass = "gr-qc", doi = "10.1103/PhysRevD.108.124037", journal = "Phys. Rev. D", volume = "108", number = "12", pages = "124037", year = "2023" }

• For SEOBNRv5HM, Pompili et al., "Laying the foundation of the effective-one-body waveform models SEOBNRv5: improved accuracy and efficiency for spinning non-precessing binary black holes", 2023, arXiv:2303.18039 <https://arxiv.org/abs/2303.18039>_::

  @article{Pompili:2023tna, author = "Pompili, Lorenzo and others", title = "{Laying the foundation of the effective-one-body waveform models SEOBNRv5: Improved accuracy and efficiency for spinning nonprecessing binary black holes}", eprint = "2303.18039", archivePrefix = "arXiv", primaryClass = "gr-qc", doi = "10.1103/PhysRevD.108.124035", journal = "Phys. Rev. D", volume = "108", number = "12", pages = "124035", year = "2023" }

• For SEOBNRv5EHM, Gamboa et al., "Accurate waveforms for eccentric, aligned-spin binary black holes: The multipolar effective-one-body model SEOBNRv5EHM", 2024, arXiv:2412.12823 <https://arxiv.org/abs/2412.12823>_::

  @article{Gamboa:2024, author={Aldo Gamboa and Alessandra Buonanno and Raffi Enficiaud and Mohammed Khalil and Antoni Ramos-Buades and Lorenzo Pompili and Héctor Estellés and Michael Boyle and Lawrence E. Kidder and Harald P. Pfeiffer and Hannes R. Rüter and Mark A. Scheel}, title={Accurate waveforms for eccentric, aligned-spin binary black holes: The multipolar effective-one-body model SEOBNRv5EHM}, year={2024}, eprint={2412.12823}, archivePrefix={arXiv}, primaryClass={gr-qc}, }

• For pSEOBNRv5PHM, Pompili et al., "A parametrized spin-precessing inspiral-merger-ringdown waveform model for tests of general relativity", 2025, arXiv:2504.10130 <https://arxiv.org/abs/2504.10130>_::

  @article{Pompili:2025cdc, author = "Pompili, Lorenzo and Maggio, Elisa and Silva, Hector O. and Buonanno, Alessandra", title = "{A parametrized spin-precessing inspiral-merger-ringdown waveform model for tests of general relativity}", eprint = "2504.10130", archivePrefix = "arXiv", primaryClass = "gr-qc", month = "4", year = "2025" }

If you build on the existing models, please cite:

• Khalil et al., "Theoretical groundwork supporting the precessing-spin two-body dynamics of the effective-one-body waveform models SEOBNRv5", 2023, arXiv:2303.18143 <https://arxiv.org/abs/2303.18143>_::

  @article{Khalil:2023kep, author = "Khalil, Mohammed and Buonanno, Alessandra and Estelles, Hector and Mihaylov, Deyan P. and Ossokine, Serguei and Pompili, Lorenzo and Ramos-Buades, Antoni", title = "{Theoretical groundwork supporting the precessing-spin two-body dynamics of the effective-one-body waveform models SEOBNRv5}", eprint = "2303.18143", archivePrefix = "arXiv", primaryClass = "gr-qc", doi = "10.1103/PhysRevD.108.124036", journal = "Phys. Rev. D", volume = "108", number = "12", pages = "124036", year = "2023" }

• Van de Meent et al., "Enhancing the SEOBNRv5 effective-one-body waveform model with second-order gravitational self-force fluxes", 2023, arXiv:2303.18026 <https://arxiv.org/abs/2303.18026>_::

  @article{vandeMeent:2023ols, author = "van de Meent, Maarten and Buonanno, Alessandra and Mihaylov, Deyan P. and Ossokine, Serguei and Pompili, Lorenzo and Warburton, Niels and Pound, Adam and Wardell, Barry and Durkan, Leanne and Miller, Jeremy", title = "{Enhancing the SEOBNRv5 effective-one-body waveform model with second-order gravitational self-force fluxes}", eprint = "2303.18026", archivePrefix = "arXiv", primaryClass = "gr-qc", doi = "10.1103/PhysRevD.108.124038", journal = "Phys. Rev. D", volume = "108", number = "12", pages = "124038", year = "2023" }

• Toubiana et al., "Measuring source properties and quasinormal mode frequencies of heavy massive black-hole binaries with LISA", 2024, arXiv:2307.15086 <https://arxiv.org/abs/2307.15086>_::

  @article{Toubiana:2023cwr, author = "Toubiana, Alexandre and Pompili, Lorenzo and Buonanno, Alessandra and Gair, Jonathan R. and Katz, Michael L.", title = "{Measuring source properties and quasinormal mode frequencies of heavy massive black-hole binaries with LISA}", eprint = "2307.15086", archivePrefix = "arXiv", primaryClass = "gr-qc", doi = "10.1103/PhysRevD.109.104019", journal = "Phys. Rev. D", volume = "109", number = "10", pages = "104019", year = "2024" }

• Gamboa et al., "Third post-Newtonian dynamics for eccentric orbits and aligned spins in the effective-one-body waveform model SEOBNRv5EHM", 2024, arXiv:2412.12831 <https://arxiv.org/abs/2412.12831>_::

  @article{Gamboa:2024imd, author = "Gamboa, Aldo and Khalil, Mohammed and Buonanno, Alessandra", title = "{Third post-Newtonian dynamics for eccentric orbits and aligned spins in the effective-one-body waveform model SEOBNRv5EHM}", eprint = "2412.12831", archivePrefix = "arXiv", primaryClass = "gr-qc", month = "12", year = "2024" }

.. |pipeline status| image:: https://git.ligo.org/waveforms/software/pyseobnr/badges/main/pipeline.svg :target: https://git.ligo.org/waveforms/software/pyseobnr/commits/main