🛰️ 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gw_agn_watcher-1.6.6.tar.gz.
File metadata
- Download URL: gw_agn_watcher-1.6.6.tar.gz
- Upload date:
- Size: 23.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.20
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e66811f7a3b92e4137268ed468b2e583b35a819f6e28f63cb269973a6462fa0b
|
|
| MD5 |
b845c8bff4240ac692e9d23c4bff7ed8
|
|
| BLAKE2b-256 |
4994e9ca96cb00e604888277cc15b153f25b69a17d2d4fde5b09b6b0231c6604
|
File details
Details for the file gw_agn_watcher-1.6.6-py3-none-any.whl.
File metadata
- Download URL: gw_agn_watcher-1.6.6-py3-none-any.whl
- Upload date:
- Size: 25.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.20
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8774028c6ebb8dbcd8e266673bf689579f908a9d74847e0dd9eadfbb197fccd3
|
|
| MD5 |
5fcaa2bc7cbbdf395a8749c23ea8bd8c
|
|
| BLAKE2b-256 |
4a80948199438e59c90d7dabf2f6c115b3679eeee09c7043499d668328f03e52
|
