This release is a pre-release and may not be stable for production use.
PycWB
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
- Support and bug reports, including an email route without a GitLab account.
- Contribution instructions and changes.
- Citation metadata and scientific citation guidance.
- Release and compatibility process.
Current native notebooks and optional integrations are listed in the example guide. The CLI synthetic example is the maintained beginner path.
3 maintainers
Metadata
3 maintainers
Release files for PycWB 1.1.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pycwb-1.1.0b1.tar.gz | 8.8 MB | Details |
Release files / pycwb-1.1.0b1.tar.gz
| Download URL | pycwb-1.1.0b1.tar.gz |
|---|---|
| Size | 8.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d1f57b6c074f87148a7fdd757d5196cd865259ec94e2e3782cf2a4b93238e0d
|
|
BLAKE2b-256 checksum How to use checksums |
66862bdcc5c9e1fab01e8b0aea680adeb0124e08fb630cf124b0559650353eee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.17
|
