Skip to content
/ bhsr Public

Black hole superradiance exclusions of ultralight bosons

License

Notifications You must be signed in to change notification settings

sebhoof/bhsr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Black Hole Superradiance for Ultralight Bosons

A Python package and data repo for calculating BHSR rates and constraining the properties of ultralight bosons.

Developer(s)Sebastian Hoof
Maintainer(s)Sebastian Hoof
LicenceBSD 3-clause licence, see the licence file for details

Results

Details on our proposed inference framework, which directly uses black hole mass and spin posterior samples to constrain ultralight bosons, can be found in our preprint [arXiv:2406.xxxxx]. More details to follow after the peer review process.

Exclusion plot of ULB mass and decay constant from BHSR data

PRELIMINARY. The plot above shows the excluded parameter region for the ULB boson mass μ and f-1 for IRAS 09149-6206 (left panel) and M33 X-7 (right panel).

How to install

Requirements

  • Python interpreter v3.10 (or higher)
  • Python packages iminuit, numba, numpy, qnm, scipy, superrad
  • Optional: Python packages emcee, jupyterlab, matplotlib, tqdm

Step-by-step guide

  1. Install the dependencies into your Python environment via python -m pip install iminuit numba numpy qnm scipy superrad
  2. Clone this repo via git clone https://github.com/sebhoof/bhsr

How to get started

We include the Jupyter notebook examples.ipynb to demonstrate a few of the capabilities of our code.

How to cite

Even if you wish to only cite our code, we still ask you to cite [arXiv:2406.xxxxx] and to include a link to this Github repo. Sadly, code citations are still not widely recognised.

We (re-)distribute posterior samples from various BH data sets. If you make use of the data included in the data/ folder, the following works should be cited:

Black hole name Samples Reference(s)
IRAS 09149-6206 M [arXiv:1705.02345], [arXiv:2009.08463]
a* [arXiv:2009.10734]
M33 X-7 (M,a*) [arXiv:0803.1834]

About

Black hole superradiance exclusions of ultralight bosons

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published