Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.

Release files for mlgw_bns 0.11.0a0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mlgw_bns 0.11.0a0
File Size Uploaded
mlgw_bns-0.11.0a0.tar.gz 1.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for mlgw_bns 0.11.0a0
File Interpreter ABI Platform
mlgw_bns-0.11.0a0-py3-none-any.whl Python 3 none any Details

Total release size: 3.6 MB

Release files / mlgw_bns-0.11.0a0.tar.gz

Download URL mlgw_bns-0.11.0a0.tar.gz
Size 1.8 MB
Tags Source
SHA-256 checksum
How to use checksums
088d6a21884ecb73b11a4f0eb6d09450bef48a1e0d9272686f58383d8ccb866a
BLAKE2b-256 checksum
How to use checksums
efc17027c74e0d46b38d30d76740f3980a04804045dbd1d9b13292b4d47314c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.13 CPython/3.9.11 Linux/5.15.0-10033-tuxedo

Release files / mlgw_bns-0.11.0a0-py3-none-any.whl

Download URL mlgw_bns-0.11.0a0-py3-none-any.whl
Size 1.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
1724f0a031a4b8925770f4125627a2f2615244877ac726fa342f4895c437dbc4
BLAKE2b-256 checksum
How to use checksums
7d5b4e9e9d91954ff920d87b25253a95dfea24d3ae1ebdee4534472b36dc8541
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.13 CPython/3.9.11 Linux/5.15.0-10033-tuxedo
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page