Skip to main content
Pre-release

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

PycWB

Documentation Build Status Coverage Releases PyPI version License

PycWB is a modular Python implementation of the coherent WaveBurst (cWB/cWB-2G) algorithms for gravitational-wave burst searches. The documentation can be found at docs.pycwb.org.

Get started

To run the bundled example from a source checkout:

conda create -n pycwb -c conda-forge python=3.13 pip nds2-client python-nds2-client lalsuite python-ligo-lw
conda activate pycwb
git clone https://git.ligo.org/yumeng.xu/pycwb.git
cd pycwb
python -m pip install .
pycwb --version
pycwb run examples/demo/user_parameters.yaml --work-dir my_first_search
pycwb progress --work-dir my_first_search

The CLI example in examples/demo/ generates synthetic data containing a loud injected burst and writes the normal pipeline outputs. It needs no detector-data account. The first run may download a roughly 53 MiB cross-talk catalog and compile numerical kernels. Use a fresh directory for each run. See Your First Search for expected outputs and troubleshooting.

Choose the matching version

A normal python -m pip install pycwb selects a stable release; --pre allows prereleases. Older releases have different dependencies and may require ROOT. Match pycwb --version to the documentation version. Development documentation can describe features not yet available on PyPI.

The current native path requires Python >=3.11 and does not require ROOT. Linux x86_64/Python 3.13 is the current CI environment. Other platform coverage and optional ROOT/PyCBC/XGBoost setup are described in the installation guide.

Run your own analysis

pycwb run user_parameters.yaml
from pycwb.workflow.run import search

search("user_parameters.yaml")

For production configuration templates, follow Setup Config Templates. Read Understanding Your Results, Reproducibility, and Validation Scope before interpreting an analysis.

Help and contributions

Current native notebooks and optional integrations are listed in the example guide. The CLI synthetic example is the maintained beginner path.

Metadata

Release files for PycWB 1.1.0b11

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

Source distribution (sdist)

Source distribution for PycWB 1.1.0b11
File Size Uploaded Provenance
pycwb-1.1.0b11.tar.gz 9.3 MB Without provenance Details

Release files / pycwb-1.1.0b11.tar.gz

Download URL pycwb-1.1.0b11.tar.gz
Size 9.3 MB
Tags Source
SHA-256 checksum
How to use checksums
0a152e4cc9ba9aea7a7cae7cae31c0973db519d063652ce5e5451042f9afe7ce
BLAKE2b-256 checksum
How to use checksums
09f146e3bf3992095d0e860ab2b6642147fdc78660adcf217f2516e4e3e5883c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Security for PycWB 1.1.0b11

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.

Release history Release notifications | RSS feed

This release
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