gwosc

library0.8.2pypypiunverified

A python interface to the Gravitational Wave Open Science Center (GWOSC) data archive. Version 0.8.2 requires Python >=3.10. Regular releases, roughly quarterly.

data

pip install gwosc

package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · GWOSC

gwosc

datapythonv0.8.2

Install

2.2s avg

Import

—

Disk

20MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.8.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 21.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.2s · import 0.000s · 22MB

20MB installed

● package 20MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GWOSC

✓ from gwosc import GWOSC

✗ from gwosc.api import GWOSC

Basic usage: list datasets and fetch event metadata from the API.

from gwosc.datasets import dataset from gwosc.api import fetch_json # List datasets datasets = dataset() print(datasets) # Query for event details json_data = fetch_json('https://www.gw-openscience.org/api/v2/events/GW150914/') print(json_data)

gwosc --version

Debug

Known issues

breakingThe API endpoint changed from /archive/ to /api/v2/. Old code using direct URL construction will break.

fix

Use the provided functions like fetch_json with the new base URL, or update URLs to https://www.gw-openscience.org/api/v2/.

affects: <0.7.0

deprecatedThe function `datasets.find_datasets` is deprecated in favor of `dataset()`.

fix

Replace `from gwosc.datasets import find_datasets` with `from gwosc.datasets import dataset` and call `dataset()`.

affects: >=0.6.0

gotchaThe `dataset()` function returns a list of URLs, not dataset names. Many users expect names and try to use them directly in API calls.

fix

Use `datasets = dataset(); [d['dataset'] for d in datasets]` to extract names if needed.

affects: all

gotchaRunning `fetch_json` without a proper user-agent may result in HTTP 403 errors from the GWOSC servers.

fix

Set the `User-Agent` header: `fetch_json(url, headers={'User-Agent': 'MyApp/1.0'})`.

affects: all

Upgrade

Version history

0.8.2latest on PyPI · released Apr 2, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

6 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/gwosc/ ↗

homepagehttps://gwosc.readthedocs.io ↗

docshttps://gwosc.readthedocs.io ↗