archeo
Bayesian framework for inferring natal kick, ancestral masses and spins of black holes.
Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 4 DOI reference(s) in README -
✓Academic publication links
Links to: arxiv.org, iop.org, zenodo.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.7%) to scientific vocabulary
Keywords
Repository
Bayesian framework for inferring natal kick, ancestral masses and spins of black holes.
Basic Info
- Host: GitHub
- Owner: wyhwong
- License: mit
- Language: Python
- Default Branch: main
- Homepage: https://pypi.org/project/archeo/
- Size: 114 MB
Statistics
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 61
Topics
Metadata Files
README.md
ARCHEO
Archeo is a Python package designed to infer the natal kick, ancestral masses, and spins of black holes in the Pair-instability Supernova (PISN) gap, with a particular focus on hierarchical black hole formation.
Our method (described in Methodology) applies to any binary black hole event detected via gravitational waves, enabling researchers to: - Infer the parental (ancestral) black holes of observed binaries. - Estimate the birth recoil velocities to determine if a black hole remains in its host environment or is ejected. - Evaluate hierarchical merger scenarios to assess whether a black hole could be a product of previous mergers.
Installation
Install via PyPI or from source.
PyPI
```bash
Basic installation (without UI)
pip3 install archeo
If you want to use the UI
pip3 install archeo[ui] ```
From source
```bash git clone https://github.com/wyhwong/archeo.git cd archeo/src
If you use poetry
poetry install
If you do not use poetry
pip3 install -r requirements.txt . ```
Usage
Please see README.md inside src folder.
Methodology
The methodology is describe in the following paper:
[1] Carlos Araújo Álvarez, Henry W. Y. Wong, Juan Calderón Bustillo. "Kicking Time Back in Black Hole Mergers: Ancestral Masses, Spins, Birth Recoils, and Hierarchical-formation Viability of GW190521." The Astrophysical Journal 977.2 (2024): 220.
Bibtex Citation:
bibtex
@article{araujo2024kicking,
title={Kicking Time Back in Black Hole Mergers: Ancestral Masses, Spins, Birth Recoils, and Hierarchical-formation Viability of GW190521},
author={Ara{\'u}jo-{\'A}lvarez, Carlos and Wong, Henry WY and Liu, Anna and Bustillo, Juan Calder{\'o}n},
journal={The Astrophysical Journal},
volume={977},
number={2},
pages={220},
year={2024},
publisher={IOP Publishing}
}
Publications
Here we list the publications that have used Archeo:
[1] Carlos Araújo Álvarez, Henry W. Y. Wong, Juan Calderón Bustillo. "Kicking Time Back in Black Hole Mergers: Ancestral Masses, Spins, Birth Recoils, and Hierarchical-formation Viability of GW190521." The Astrophysical Journal 977.2 (2024): 220.
[2] The LIGO Scientific Collaboration, the Virgo Collaboration, the KAGRA Collaboration. "GW231123: a Binary Black Hole Merger with Total Mass 190-265 $M_\odot$." arXiv preprint arXiv:2507.08219.
Getting Help
The code is maintained by Henry Wong under Juan Calderon Bustillo's supervision. You can find the list of contributors here. Please report bugs by raising an issue on our GitHub repository.
Owner
- Name: Henry, Wai Yin Wong
- Login: wyhwong
- Kind: user
- Location: Hong Kong
- Company: Sebit Company Limited
- Website: https://www.linkedin.com/in/wyhwong/
- Repositories: 3
- Profile: https://github.com/wyhwong
Studying physics is the best decision I have ever made.
GitHub Events
Total
- Release event: 53
- Watch event: 2
- Delete event: 7
- Push event: 195
- Pull request event: 2
- Create event: 60
Last Year
- Release event: 53
- Watch event: 2
- Delete event: 7
- Push event: 195
- Pull request event: 2
- Create event: 60
Packages
- Total packages: 1
-
Total downloads:
- pypi 1,079 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 64
- Total maintainers: 1
pypi.org: archeo
Bayesian framework for inferring natal kick, ancestral masses and spins of black holes.
- Homepage: https://pypi.org/project/archeo/
- Documentation: https://archeo.readthedocs.io/
- License: MIT
-
Latest release: 1.7.0
published 6 months ago
Rankings
Maintainers (1)
Dependencies
- python 3.11-slim-buster build
- 129 dependencies
- corner 2.2.2
- gwsurrogate 0.5.0
- jupyterlab 4.0.3
- matplotlib 3.7.2
- notebook 7.0.0
- numpy 1.25.1
- pandas 2.0.3
- python >=3.10,<3.13
- pyyaml 6.0.1
- scipy 1.11.1
- seaborn 0.12.2
- setuptools ^68.2.2
- surfinbh 1.2.0
- tables 3.8.0
- wheel ^0.41.3