Analyse Open Gravitational Wave Data in MATLAB

This is a tutorial demonstrating how to access open gravitational wave data and publish reusable and reproducible analyses in MATLAB
Updated 16 Nov 2023

View open-gravitational-wave-data-matlab on File Exchange Open in MATLAB Online

Analyse Open Gravitational Wave Data in MATLAB®

A MATLAB Live Script with accompanying

to access and analyze Gravitational Wave data sets from the Gravitational Wave Open Science Center (GWOSC) database

Get started

Use this tutorial to get started with freely available gravitational wave data at GWOSC directly from MATLAB.

  • No downloads, no installations
  • Open directly in MATLAB Online by clicking this Open in MATLAB Online
  • Step-by-step tutorial shows how to
    • Re-use available gravitational wave data. Access a list of openly available events and sessions from LIGO, Virgo and Kagra
    • Query and inspect the metadata associated with these projects using commands directly from MATLAB (RESTful API)
    • Avoid downloads. Access specific data from within the database directly and avoid time-consuming downloads of large data
    • Read in HDf5 data from within MATLAB corresponding to specific sampling rates and detectors
    • Analyze gravitational wave data using standard signal processing in time and frequency domains re-using open community code from File Exchange
    • Let others run your code and reproduce your results quickly. Pubish the results on GitHub and make them accessible using Open With MATLAB Online
    • Allow people to cite you! Generate a DOI for your code by linking your GitHub repository to one of several DOI-generating sites.
  • Live Script contains easy-to-use menus for user to click and select different datasets
  • Available on File Exchange for directly installing onto your MATLAB path with one click using the Add-Ons button
  • Accompanying Jupyter notebook (.ipynb) for use in a Jupyter environment. More information on MATLAB kernel here
  • Accompanying Code Ocean reproducible capsule (.m) for one-click reproducibility of the code by anyone, including reviewers.

About the Gravitational Wave Open Science Center

The Gravitational Wave Open Science Center (GWOSC) is a public repository of gravitational wave events and experimental sessions from LIGO, Virgo and Kagra for the community. It can be accessed at Here is a list of available GW events from GWOSC.

For advanced users A detailed guide to the GWOSC API can be found here. To access the REST API use the MATLAB webread function

Required Products

This tutorial uses the following products

  • Signal Processing Toolbox

This code has been developed and tested using MATLAB 2023a

Note This tutorial works best when delivered by a tutor. It is important to highlight best practices when working with Open Data, publishing Open Code or making research output reproducible

Cite As

Shubo Chakrabarti, and Temo Vekua. Access Gravitational Wave Data with MATLAB. Code Ocean, 2023, doi:10.24433/CO.6147849.V1.

View more styles

Shubo Chakrabarti (2024). Analyse Open Gravitational Wave Data in MATLAB (, GitHub. Retrieved .

MATLAB Release Compatibility
Created with R2023b
Compatible with any release
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes

See release notes for this release on GitHub:


To view or report issues in this GitHub add-on, visit the GitHub Repository.
To view or report issues in this GitHub add-on, visit the GitHub Repository.