Welcome to pycWB’s documentation!¶

pycWB is a modularized Python package for gravitational wave burst search based on the core function of cWB.

Getting Started¶

Installation¶

PycWB is available on PyPI. You can install it with pip. Some dependencies are required to be installed before installing pycWB with pip. The easiest way is to install them with conda.

conda create -n pycwb "python>=3.9,<3.11"
conda activate pycwb
conda install -c conda-forge root=6.26.10 healpix_cxx=3.81 nds2-client python-nds2-client lalsuite setuptools_scm cmake pkg-config
python3 -m pip install pycwb

Run your first burst search¶

In your first burst search, we will use a built-in noise generator and waveform generator to minimize the requirement for external data. What you need is just one configuration file in YAML format.

To start with, copy the example configuration folder from the source code or download the user_parameters_injection.yaml manually from here.

cp -r [path_to_source_code]/examples/injection my_first_search

Now, you are all set! You can directly run the example in the terminal with the pycwb run command

pycwb run user_parameters_injection.yaml

Or you can open the juptyer notebook pycwb_injection.ipynb (download here) and run the search step by step

Go deeper into pycWB.search¶

If you want to know more about the search process, please refer to Go deeper into pycWB.search

Step by step injection!¶

If you want to know more about the injection process step by step, please refer to Step by step injection search or the juptyer notebook pycwb_injection.ipynb

Command line interfaces (CLI)¶

It is recommended to use the command line interfaces (CLI) to run the search. You can get help by running the command with the -h option. Here are the current available commands:

Available Commands¶
Command	Description
`pycwb run`	Run a single search
`pycwb batch-setup`	Setup batch run
`pycwb batch-runner`	Runner for batch run, used for the job submission
`pycwb post-process`	Run the post process workflow
`pycwb gwosc`	Download data from GWOSC and setup the search
`pycwb flow`	Run search with prefect flow
`pycwb xtalk`	Convert xtalk file
`pycwb merge-catalog`	Merge catalog files
`pycwb server`	Run a simple server to show the results

Basic Workflow¶