Skip to main content

ripple 🌊

A JAX-based package for differentiable gravitational-wave waveform generation

pre-commit.ci status CI coverage PyPI Python docs license

ripple is a JAX-based package for differentiable gravitational-wave waveform generation. By implementing waveform models as differentiable JAX functions, ripple enables gradient-based inference and runs natively on GPU, making it well-suited for use within modern probabilistic inference pipelines such as Jim.

Supported waveforms:

  • TaylorF2 — fast post-Newtonian waveform, aligned spins, tidal-capable
  • IMRPhenomXAS — aligned-spin binary black holes
  • IMRPhenomXPHM — precessing spins with higher-order modes
  • IMRPhenomXAS_NRTidalv3 — tidal corrections for binary neutron star mergers
  • IMRPhenomXP_NRTidalv3 — precessing spins with tidal corrections
  • SineGaussian — time-domain burst waveform
  • PulsarSignal — continuous-wave signal from a spinning neutron star
  • etc.

See the Waveform Catalogue for the full list of supported waveforms.

For a quick introduction, see the Quick Start guide.

Installation

The simplest way to install ripple is through pip:

pip install rippleGW

This will install the latest stable release and its dependencies. ripple is built on JAX. By default, this installs the CPU version of JAX. If you have an NVIDIA GPU, install the CUDA-enabled version:

pip install rippleGW[cuda]

If you want to install the latest version of ripple, you can clone this repo and install it locally:

git clone https://github.com/GW-JAX-Team/ripple.git
cd ripple
pip install -e .

We recommend using uv to manage your Python environment. After cloning the repository, run uv sync to create a virtual environment with all dependencies installed.

Origins

ripple was originally developed as tedwards2412/ripple by Thomas Edwards and others. The original repository is no longer actively maintained; this fork is the active continuation of the project.

Attribution

If you use ripple in your research, please cite the accompanying paper:

@article{Edwards:2023sak,
    author = "Edwards, Thomas D. P. and Wong, Kaze W. K. and Lam, Kelvin K. H. and Coogan, Adam and Foreman-Mackey, Daniel and Isi, Maximiliano and Zimmerman, Aaron",
    title = "{Differentiable and hardware-accelerated waveforms for gravitational wave data analysis}",
    eprint = "2302.05329",
    archivePrefix = "arXiv",
    primaryClass = "astro-ph.IM",
    doi = "10.1103/PhysRevD.110.064028",
    journal = "Phys. Rev. D",
    volume = "110",
    number = "6",
    pages = "064028",
    year = "2024"
}

Metadata

Release files for rippleGW 0.5.0

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

Source distribution (sdist)

Source distribution for rippleGW 0.5.0
File Size Uploaded Provenance Actions
ripplegw-0.5.0.tar.gz 522.9 kB Without provenance Details for ripplegw-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rippleGW 0.5.0
File Interpreter ABI Platform Actions
ripplegw-0.5.0-py3-none-any.whl Python 3 none any Details for ripplegw-0.5.0-py3-none-any.whl

Total release size: 774.9 kB

Release files / ripplegw-0.5.0.tar.gz

Download URL ripplegw-0.5.0.tar.gz
Size 522.9 kB
Tags Source
SHA-256 checksum
How to use checksums
79f3e3101ef6752cfc9d21e52103fe3d815df8bd58445688c28173084b94f426
BLAKE2b-256 checksum
How to use checksums
f958fa1cd15057ce7007d82ccd1a1ce5ef788637db70b81a95af5673ede83aae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / ripplegw-0.5.0-py3-none-any.whl

Download URL ripplegw-0.5.0-py3-none-any.whl
Size 251.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5e11b04eaac71fe10731681e645f28ff5a60fe512218231230ad011f2313112
BLAKE2b-256 checksum
How to use checksums
5472602c722f31b3a90d811558044db0998b3707009f688f82d1b781e7eb25d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for rippleGW 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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