jkanner / pe-viewer

A web app to make plots of posterior samples, skymaps, and waveforms for gravitational wave events.
1 stars 3 forks source link

GW Event Viewer

Make plots of waveforms, source parameters, and skymaps for gravitational-wave events.

Run app: Open in Streamlit

Source code: jkanner/pe-viewer

Introduction

The gravitational-wave observatories LIGO, Virgo, and KAGRA observe signals from transient astrophysical events, including mergers of binary black holes and binary neutron stars.

This web app creates plots to display information about these mergers, such as the source mass and location.

Learn more at gwosc.org.

Event Selection

Each "event" is a compact object merger observed in gravitational waves. The event list corresponds to all confident events in the Gravitational Wave Transient Catalog.

From the sidebar at left, you can select one or more events. After selecting an event, the app will find publicly available parameter estimation posterior samples and download them from zenodo. All of the displayed plots will be derived from these samples.

Sample Selection

This app uses the posterior samples which are labeled as the Default PE in the online Gravitational Wave Transient Catalog. In many cases, the 1-D and 2-D posterior plots are made using mixed samples, which are a combination of samples from mulitple PE runs.

Zenodo data releases

Posterior samples used in this app are available in the zenodo LVK Community:

2-D Plots

This feature shows a "triangle" plot that can reveal correlations between parameters. Parameter probability distributions from all selected events will be shown on the same plot.

You can use the drop-down menu above the triangle plot to select which parameters you would like to plot.

Posterior samples are selected based on the waveform_family attribute stored in the GWOSC Event Portal. This typically corresponds to the samples used to create tables in GWTC publications.

Skymap

Skymaps shows the reconstructed source position for an event. These are created at runtime from the posterior samples using the python package ligo.skymap.

All Parameters

Selecting All Parameters will display one dimensional posterior plots for a large number of parameters for the selected events. If two or more events are selected, then the values for different events will be displayed together.

Posterior samples are selected based on the waveform_family attribute stored in the GWOSC Event Portal. This typically corresponds to the samples used to create tables in GWTC publications.

Waveform

The app will select the maximum likelihood sample, and then construct the associated waveform using the pycbc wrappings to lalsimulation. The waveform may be listened to as an audio file and/or downloaded. The waveform is projected onto each detector, and plotted along with the detector data, so that you can compare how the data looks against the theoretical waveform.

The waveform app will only work with the first selected event - events are ignored for this feature.

Make plots like this!

This app uses code from the package pesummary to create many of the displayed plots.

Python code for these plots is demonstrated in a Jupyter Notebook in the GWTC-3 Sample Release.

Acknowledgment

This app makes use of data and software obtained from the Gravitational Wave Open Science Center, a service of LIGO Laboratory, the LIGO Scientific Collaboration, the Virgo Collaboration, and KAGRA. Black hole image adopted from art by Aurore Simonnet at Sonoma State.