MAGGPY is a Python-based simulation tool designed to model the joint population of gravitational-wave (GW) sources—specifically binary neutron star (BNS) and neutron star–black hole (NSBH) mergers—and short gamma-ray bursts (GRBs). It enables realistic connections between compact binary coalescence (CBC) populations and high-energy astrophysical transients observed by gamma-ray detectors like Fermi. By linking gravitational and electromagnetic channels, MAGGPY supports studies of the physical conditions required for jet formation and GRB emission in the context of multi-messenger astrophysics.
Key features
Joint GW–GRB Population Modeling
Constructs a consistent synthetic population of BNS/NSBH mergers and their associated GRBs, using astrophysical inputs and observed GRB catalogs.
GRB Parameter Inference
Extracts phenomenological GRB properties such as jet opening angles and jet-launching efficiencies by comparing simulated and observed populations.
Flexible Jet and Emission Models
Allows users to implement and test a variety of GRB jet structures, including top-hat and structured jets, to explore model-dependent detection rates.
Multi-Messenger Selection Effects
Quantifies how beaming, viewing angle, detector sensitivity, and redshift distribution affect the overlap between GW and GRB-detected events.
Instrument-Agnostic Input
Compatible with simulated populations from any gravitational-wave detector network, and designed to integrate with real or mock GRB datasets.
Statistical Analysis and Visualization
Provides tools to evaluate population-level trends, such as detection fractions and angular distributions, with options for customized plotting and output.
Use cases
MAGGPY’s primary use is to investigate the connection between GW sources and GRBs by modeling how populations of merging compact binaries produce observable gamma-ray signals. It enables researchers to:
- Constrain physical properties of GRB jets using joint detection statistics.
- Explore how GW and GRB detector sensitivities impact observable rates.
- Predict detection outcomes for current and future observatories.
- Guide theoretical interpretations of GW-GRB associations and non-detections.
Extension: MAGGPY-NextG
MAGGPY-NextG builds on the MAGGPY framework to simulate joint GW–GRB detection prospects for next-generation observatories, including the Einstein Telescope and Cosmic Explorer. It accounts for future detector sensitivities and EM instrument configurations to project multi-messenger detection yields and inform observational strategies.
Link: [Repository access upon request – not yet publicly available]