Skip to content
Tools and tutorials for working with waveforms from the SXS waveform catalog
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Example scripts to interact with the SXS Catalog ( and its data, hosted on Zenodo ( The data in the catalog is described in

This repo contains the following python scripts:

  • -- download waveforms, horizon quantities, and metadata for all binary-black-holes simulations in the SXS catalog
  • -- download publicly available metadata for the catalog into JSON files
  • -- convert an SXS waveform into the LVC format (BETA)
  • -- convert an SXS metadata.txt file to JSON format
  • -- compare two different SXS waveforms in the LVC format, checking if attributes, splines, and time series are the same
  • -- compare SXS data in the LVC format to data in the SXS format, checking that they agree

This repo contains the following notebooks in Examples/:

  • sxs_catalog_download_example.ipynb -- how to download and interact with catalog data
  • sxs_metadata_example.ipynb -- how to download and manipulate zenodo metadata
  • sxs_arxiv_metadata_example.ipynb -- how to download and manipulate sxs metadata included in arXiv:1904.04831
  • waveform_tutorial.ipynb -- how to work with finite-radius waveforms and extrapolated waveforms, and how to compute the wave polarizations at a chosen sky location



Please send questions to

You can’t perform that action at this time.