https://github.com/sebhoof/bhsr
Black hole superradiance exclusions of ultralight bosons
https://github.com/sebhoof/bhsr
axions blackholes physics superradiance
Last synced: 10 months ago
JSON representation
Black hole superradiance exclusions of ultralight bosons
- Host: GitHub
- URL: https://github.com/sebhoof/bhsr
- Owner: sebhoof
- License: bsd-3-clause
- Created: 2023-04-25T10:33:46.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T10:39:40.000Z (about 1 year ago)
- Last Synced: 2025-04-11T12:05:21.428Z (about 1 year ago)
- Topics: axions, blackholes, physics, superradiance
- Language: Jupyter Notebook
- Homepage:
- Size: 28 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.10337]](https://arxiv.org/abs/2406.10337).
More details to follow after the peer review process.
### Statistical analysis framework
[](https://arxiv.org/abs/2406.10337)
**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](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.10337]](https://arxiv.org/abs/2406.10337) 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]](https://arxiv.org/abs/1705.02345), [[arXiv:2009.08463]](https://arxiv.org/abs/2009.08463) |
| | _a*_ | [[arXiv:2009.10734]](https://arxiv.org/abs/2009.08463) |
| M33 X-7 | _(M,a*)_ | [[arXiv:0803.1834]](https://arxiv.org/abs/0803.1834) |