gwtails
This is a Python package to analyze post-merger late-time tails in eccentric binary black hole (BBH) mergers.
This code is based on the paper "Phenomenology and origin of late-time tails in eccentric binary black hole mergers" (https://arxiv.org/abs/2407.04682) by Islam, Faggioli, Khanna, Field, van de Meent and Buonanno. Here, we inspect waveforms produced by merging eccentric binary black holes (BBH). These waveforms are all generated using black hole perturbation theory. The trajectories are described by the dynamics of the point-particle orbiting the Kerr black hole using effective-one-body formalism: http://arxiv.org/abs/gr-qc/9811091, http://arxiv.org/abs/gr-qc/0001013, http://arxiv.org/abs/2405.19006. These trajectories are then fed into the time-domain Teukolsky solver developed by Gaurav Khanna and collaborators: http://arxiv.org/abs/gr-qc/0703028, http://arxiv.org/abs/0803.0317, http://arxiv.org/abs/0803.0317, http://arxiv.org/abs/1003.0485, http://arxiv.org/abs/1108.1816, http://arxiv.org/abs/arXiv:2010.04760.
Getting the package
The latest development version will always be available from the project git repository:
git clone https://github.com/tousifislam/gwtails
Issue tracker
Known bugs are recorded in the project bug tracker: https://github.com/tousifislam/gwtails/issues
License
This code is distributed under the MIT License. Details can be found in the LICENSE file.
Maintainer
Tousif Islam
Citation guideline
If you make use of the gwtails framework, please cite the following two papers:
@article{Islam:2024rhm,
author = "Islam, Tousif and Faggioli, Guglielmo and Khanna, Gaurav and Field, Scott and van de Meent, Maarten and Buonanno, Alessandra",
title = "{Phenomenology and origin of late-time tails in eccentric binary black hole mergers}",
eprint = "2407.04682",
archivePrefix = "arXiv",
primaryClass = "gw-qc",
month = "7",
year = "2024"
}
@article{Islam:2025wci,
author = "Islam, Tousif and Faggioli, Guglielmo and Khanna, Gaurav",
title = "{Bayesian analysis of late-time tails in spin-aligned eccentric binary black hole mergers}",
eprint = "2511.21898",
archivePrefix = "arXiv",
primaryClass = "gr-qc",
month = "11",
year = "2025"
}
Papers that have used gwtails in their analysis
- 'Gravitational waves from the late inspiral, transition, and plunge of small-mass-ratio eccentric binaries'; Devin R. Becker, Scott A. Hughes, Gaurav Khanna; https://arxiv.org/abs/2511.21897
- 'Bayesian analysis of late-time tails in spin-aligned eccentric binary black hole mergers'; Tousif Islam, Guglielmo Faggioli, Gaurav Khanna; https://arxiv.org/abs/2511.21898
- 'Phenomenology and origin of late-time tails in eccentric binary black hole mergers'; Tousif Islam, Guglielmo Faggioli, Gaurav Khanna, Scott E. Field, Maarten van de Meent, Alessandra Buonanno; https://arxiv.org/abs/2407.04682
Metadata
Release files for gwtails 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gwtails-0.1.0.tar.gz | 14.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gwtails-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.5 kB
Release files / gwtails-0.1.0.tar.gz
| Download URL | gwtails-0.1.0.tar.gz |
|---|---|
| Size | 14.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5a011cc2f446e147444144d0a6a896347c04a4ab0596e1cbfd4741f866f7214
|
|
BLAKE2b-256 checksum How to use checksums |
32830bded70fac70f344dccd65de0e8c85ff5040d66ac34f00e3709d245fba58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 26, 2026.
Transparency logRelease files / gwtails-0.1.0-py3-none-any.whl
| Download URL | gwtails-0.1.0-py3-none-any.whl |
|---|---|
| Size | 13.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dde7beff6d83f04cbf62a29ade5cfa7a15b71c6802371ba1e22971ebc0df8c44
|
|
BLAKE2b-256 checksum How to use checksums |
8961fb4d4da7e1135cf31da6afbf83feedbaaddda50568ecc5d78906c3947f56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 26, 2026.
Transparency log