🛰️ gw_agn_watcher
Overview
gw_agn_watcher is a Python package for the automated crossmatching of gravitational-wave (GW) sky maps from the LIGO–Virgo–KAGRA (LVK) Collaboration with ** ZTF alerts and AGN catalogs** using ALeRCE infrastructure.
It enables systematic searches for electromagnetic counterparts to compact binary mergers, with a particular focus on mergers that may occur in active galactic nuclei (AGN) disks.
Key Features
- Predicts the chirp mass of the GW superevent
- 📡 Ingest LVK skymaps (
.fits, HEALPix format) - 🌌 Crossmatch ZTF alerts with AGN catalogs (e.g., Milliquas)
- 🧠 Apply ML-based filters using ALeRCE classifiers, Pan-STARRS morphology, and Deep Real/Bogus scores
- 📅 Temporal and spatial filtering relative to the GW trigger time and sky localization
- 🎯 Host-galaxy association and ranking based on 2σ GW distance posteriors
- 🗺️ Visualization tools for probability maps, candidate locations, and sky coverage
- 🔧 Modular and extensible — suitable for ToO planning, multi-messenger analyses, and survey follow-up
Installation
pip install gw_agn_watcher
Citation
If you use this package, please cite:
@ARTICLE{2026arXiv260304342B,
author = {{Bommireddy}, Hemanth and {Forster}, Francisco and {McMahon}, Isaac and {Pavez Herrera}, Manuel and {Cartier}, Regis and {Olivares Estay}, Felipe and {Hern{\'a}ndez Garc{\'\i}a}, Lorena and {Mart{\'\i}nez Aldama}, Mary Loli and {Mu{\~n}oz Arancibia}, Alejandra},
title = "{A Broker Integrated Algorithm for Gravitational Wave - Electromagnetic Counterpart Searches in O4a and O4b Runs}",
journal = {arXiv e-prints},
keywords = {High Energy Astrophysical Phenomena, Instrumentation and Methods for Astrophysics},
year = 2026,
month = mar,
eid = {arXiv:2603.04342},
pages = {arXiv:2603.04342},
doi = {10.48550/arXiv.2603.04342},
archivePrefix = {arXiv},
eprint = {2603.04342},
primaryClass = {astro-ph.HE},
adsurl = {https://ui.adsabs.harvard.edu/abs/2026arXiv260304342B},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
1 maintainer
Metadata
1 maintainer
Release files for gw-agn-watcher 1.6.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gw_agn_watcher-1.6.6.tar.gz | 23.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gw_agn_watcher-1.6.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 49.6 kB
Release files / gw_agn_watcher-1.6.6.tar.gz
| Download URL | gw_agn_watcher-1.6.6.tar.gz |
|---|---|
| Size | 23.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e66811f7a3b92e4137268ed468b2e583b35a819f6e28f63cb269973a6462fa0b
|
|
BLAKE2b-256 checksum How to use checksums |
4994e9ca96cb00e604888277cc15b153f25b69a17d2d4fde5b09b6b0231c6604
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.20
|
Release files / gw_agn_watcher-1.6.6-py3-none-any.whl
| Download URL | gw_agn_watcher-1.6.6-py3-none-any.whl |
|---|---|
| Size | 25.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8774028c6ebb8dbcd8e266673bf689579f908a9d74847e0dd9eadfbb197fccd3
|
|
BLAKE2b-256 checksum How to use checksums |
4a80948199438e59c90d7dabf2f6c115b3679eeee09c7043499d668328f03e52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.20
|
