ligo.skymap¶
The ligo.skymap package provides tools for reading, writing, generating, and
visualizing gravitational-wave probability maps from LIGO, Virgo, and KAGRA.
Some of the key features of this package are:
Command line tool bayestar-localize-coincs: BAYESTAR, providing rapid, coherent, Bayesian, 3D position reconstruction for compact binary coalescence events
Command line tool ligo-skymap-from-samples: Create 3D sky maps from posterior sample chains using kernel density estimation
Command line tool ligo-skymap-plot: An everyday tool for plotting HEALPix maps
Module
ligo.skymap.plot.allsky: Astronomical mapmaking tools for perfectionists and figure connoisseurs
This illustration of the position of GW170817, prepared using ligo.skymap,
illustrates the main features of this package: rapid localization of compact
binaries with BAYESTAR [1], three-dimensional density estimation
[2] [3], cross-matching with
galaxy catalogs, and visualization of gravitational-wave sky maps.
Reproduced from [4].¶
Quick Start, Tutorials¶
Modules¶
Coordinate Frames (ligo.skymap.coordinates)¶
I/O and Data Format Support (ligo.skymap.io)¶
Plotting and Visualization (ligo.skymap.plot)¶
Sky Map Postprocessing (ligo.skymap.postprocess)¶
Localization¶
Utilities¶
Command Line Tools¶
BAYESTAR Rapid Sky Localization¶
Sky Map Visualization¶
- GeoJSON Contours (
ligo-skymap-contour) - Multi-Order-Coverage (MOC) Contours (
ligo-skymap-contour-moc) - 2D All-Sky Plots (
ligo-skymap-plot) - Airmass Plots (
ligo-skymap-plot-airmass) - Coherence vs. incoherence Bayes factor plots (
ligo-skymap-plot-coherence) - Observability Plots (
ligo-skymap-plot-observability) - 3D Volume Rendering (
ligo-skymap-plot-volume)
Postprocessing¶
- Joint Sky Localization (
ligo-skymap-combine) - Easter Egg: List Most Probable Constellations (
ligo-skymap-constellations) - Posterior Samples to FITS Files (
ligo-skymap-from-samples) - Plot Summary Statistics (
ligo-skymap-plot-stats) - Gather Summary Statistics (
ligo-skymap-stats) - Flatten Multi-Resolution Sky Maps (
ligo-skymap-flatten) - Unflatten Multi-Resolution Sky Maps (
ligo-skymap-unflatten)