Skip to main content

Accelerating gravitational wave template generation with machine learning.

Project description

CI Pipeline for mlgw_bns Documentation Status PyPI version Code style: black Coverage Status Downloads

Machine Learning for Gravitational Waves from Binary Neutron Star mergers

This package's purpose is to speed up the generation of template gravitational waveforms for binary neutron star mergers by training a machine learning model on a dataset of waveforms generated with some physically-motivated surrogate.

It is able to reconstruct them with mismatches lower than 1/10000, with as little as 1000 training waveforms; the accuracy then steadily improves as more training waveforms are used.

Currently, the only model used for training is TEOBResumS, but it is planned to introduce the possibility to use others.

The documentation can be found here.

Installation

To install the package, use

pip install mlgw-bns

For more details see the documentation.

Changelog

Changes across versions are documented since version 0.10.1 in the CHANGELOG.

Inner workings

The main steps taken by mlgw_bns to train on a dataset are as follows:

  • generate the dataset, consisting of EOB waveforms
  • decompose the Fourier transforms of the waveforms into phase and amplitude
  • downsample the dataset to a few thousand points
  • compute the residuals of the EOB waveforms from PN ones
  • apply a PCA to reduce the dimensionality to a few tens of real numbers
  • train a neural network on the relation between the waveform parameters and the PCA components

After this, the model can reconstruct a waveform within its parameter space, resampled at arbitrary points in frequency space.

In several of the training steps data-driven optimizations are performed:

  • the points at which the waveforms are downsampled are not uniformly chosen: instead, a greedy downsampling algorithm determines them
  • the hyperparameters for the neural network are optimized, according to both the time taken for the training and the estimated reconstruction error, also varying the number of training waveforms available.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mlgw_bns-0.11.0.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

mlgw_bns-0.11.0-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

Details for the file mlgw_bns-0.11.0.tar.gz.

File metadata

  • Download URL: mlgw_bns-0.11.0.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.1 CPython/3.9.11 Linux/5.15.0-10047-tuxedo

File hashes

Hashes for mlgw_bns-0.11.0.tar.gz
Algorithm Hash digest
SHA256 3683581b824af66d381cec5fc5ef4b995d3bb1f6841fb9deb220e2b9e41aea8b
MD5 e8750bb070832f95412178dc178ec437
BLAKE2b-256 cfec154b119c252b3644285da43d071a2975bfd29296224daa9193e2767d3088

See more details on using hashes here.

File details

Details for the file mlgw_bns-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: mlgw_bns-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.2.1 CPython/3.9.11 Linux/5.15.0-10047-tuxedo

File hashes

Hashes for mlgw_bns-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 69f7df4aaa89f439015fdf1fb75b226635dac890ef1e02bf97f5aa64b7438a02
MD5 50eedcb3fca42ca86e685a911dac5922
BLAKE2b-256 5fc8ff5537d494a0605900a983680dfe83161c34ac1b38568e1af897d823df06

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page