Changelog

cWB has been in active development since 2003 and it has been used to analyze all scientific data collected by the LIGO-Virgo detectors ever since. In 2009 the project migrated a first time to SVN. In 2018, it migrated a second time on git. Since 2019, cWB sources are released publicly on gitlab.com.

Commits

• library changelog

• config changelog

cWB public releases

cWB-6.4.8.0 - 2026-07-10

• Highlights

  This release consolidates the 6.4.6.x/6.4.7.0 development line, and a second, independent development line (new_public), into a single, validated public version. It brings a multi-threaded (OpenMP) Coherence and SuperCluster stage for faster 2G reconstructions, the xmdc (eXtended MDC) class for injections uniformly distributed in volume, an extended set of wave-packet patterns and targeted-search options, a SHAP-based diagnostic report and new rho0 definitions for the XGBoost post-production, the wavescan spectrogram tool, and a round of correctness fixes found while hardening the CMake build and adding an automated GW150914 end-to-end regression test to the CI pipeline.

• Release Notes

  • Performance: parallelized the per-lag Coherence and SuperCluster loops with OpenMP (validated bit-identical to the serial result); removed an O(nLag²) redundancy in the Coherence loop. OpenMP is an optional dependency: on a toolchain that cannot detect it, the build now falls back to the original serial loop instead of failing. See the OpenMP parallelization page for what is parallelized, when it helps, and how to combine it with staged execution.

  • New feature: the xmdc class, for MDC injection sets distributed uniformly in volume (integrated from the 6.4.7.0 line). See the XMDC engine page for the configuration, workflow and a full example.

  • New feature: 5 additional wave-packet patterns (pattern = 11-15: 5|, 5-, 5+, 5x, 5o); an adaptive select_subrho that auto-rescales for multi-pattern searches when set negative; a chirp-enhance pixel-selection mode in network::getNetworkPixels (enabled with a negative bpp); configurable cluster_Tgap / cluster_Fgap clustering gaps (previously hardcoded); a targeted_csel option to apply the targeted skymask in the cluster selection stage as well; “v1” delta/gamma regulators (--regulators v1); and a simulation=-1 mode (like simulation=1, but with a per-injection-type range of factors). See Coherence and SuperCluster parameters for the full parameter reference.

  • New feature: SHAP-value diagnostic plots and two new rho0 definitions (sqrt(ecor), sqrt(likelihood)) in the XGBoost post-production. See XGBoost.

  • New tool: wavescan, a wavelet-based spectrogram scan; when the CED selection threshold cedRHO is negative, the CED report substitutes its usual STFT spectrograms with wavescan plots.

  • Bug fixes: a segfault in the mdc XPHM_ST path with non-XP approximants; a CWB::config field read-order mismatch and an off-by-one in its Streamer version guard (blocked staged-job resume); a double-free in monster::deallocate(); a data race in the OpenMP SuperCluster verbose block; the dictionary (*_rdict.pcm) install rule now works across ROOT versions, both before and after ROOT 6.40’s naming change; various Condor/OSDF submission fixes.

  • Testing / CI: a fully self-contained GW150914 end-to-end pipeline regression test; a Catch2 round-trip test for CWB::config serialization; valgrind memcheck coverage.

  • Build: continuous-integration coverage for ROOT 6.30/6.32/6.34, additionally validated on ROOT 6.36 (the recommended target for a local CMake install; see the library README for the supported-ROOT-versions notes, including why ROOT 6.40 is not yet supported).

  • Cleanup: retired the unused WDMOverlap and HistoryStage classes and macros that were never ROOT6-compatible.

• Source distribution

  Sources are available on our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.4.8.0

cWB-6.4.6.9 (O4c) - 2026-03-02

• Highlights

  Consolidation release for the O4c run. Adds the xTHtml class, an in-house replacement for ROOT’s THtml (removed starting with ROOT 6.36) so the reports/documentation generation keeps working on modern ROOT; a rewritten regression class ported from the cwbXP line (S. Klimenko), with the previous implementation kept available as regressionOLD for backward compatibility; and a wide sweep of memory-leak and correctness fixes.

• Release Notes

  • xTHtml: new class (cherry-picked and adapted from ROOT’s own src/root/html/) standing in for the deprecated THtml, needed because ROOT >= 6.36 drops it.

  • regression: rewritten class from the cwbXP line; the previous behaviour remains available via --regression OLD / --monster_bugfix false in user_parameters.C; new l_LPE resolution-level parameter.

  • Bug fixes: an AVX division bug in WAT (gWATAVX_BUGFIX, opt-out with --watavx_bugfix false); several memory leaks (History/HistoryStage TList release, StageAlreadyPresent, assorted delete/delete[] mismatches); NaN/Inf handling hardened throughout the XGBoost prediction pipeline; a CWB::config revision-28 read fix; -z noexecstack added for ROOT/cling compatibility.

  • Online/computing: OSG/OSDF support and CWB::Toolbox::findFilesWithinGPS; CWB_INIT_SCRIPT environment variable for Condor DAG/sub generation.

• Source distribution

  Sources are available on our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.4.6.9

cWB-6.4.6.0 (O4b) - 2024-02-22

• Highlights

  This release ( cWB-6.4.6.0 ) brings the latest upgrades to the online low-latency pipeline, and continues maturing the XGBoost machine-learning event selection introduced in 6.4.5.0 – including dedicated support for targeted searches. The ANN classifier is formally deprecated in favour of XGBoost.

• Release Notes

  • Online pipeline: GraceDB skymap followup, XGBoost model results exposed on the online web pages, faster CED association and significance calculation for the daily/weekly reports.

  • XGBoost: new targeted-search support (targeted, targeted_name, targeted_ra, targeted_dec and the derived erA0/erA10/netSens1/skyDist01 features); scale_pos_weight hyperparameter tuning; training-input file format extended to a per-file [fname, cut, fraction] selection (backward compatible); reading of ROOT files switched from RDataFrame to uproot for speed.

  • Deprecation: the ANN-based classifier is deprecated as of this release; XGBoost is the supported machine-learning event-selection method going forward.

• Source distribution

  Sources are available on our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.4.6.0

cWB-6.4.5.0 (O4a) - 2023-08-16

• Highlights

  This release ( cWB-6.4.5.0 ) is a cWB 2G minor upgrade that introduces the XGBoost machine-learning classifier for post-production event selection and a new low-latency online pipeline.

• Release Notes

  • New feature: the cwb_xgboost command, applying a gradient- boosted-tree classifier (XGBoost) to post-production event selection.

  • New feature: the online pipeline (cwb_online_exec) for low-latency operations.

  • Added the O4 Rates & Populations injection-log format converter (CWB::mdc::RnPinjections2log).

  • cwb_gwosc formalized as a dedicated installed executable.

• Source distribution

  Sources are available on our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.4.5.0

cWB-6.4.1 - 2021-12-23

• Highlights

  This new release ( cWB-6.4.1 ) is a major upgrade of cWB: it fixes minor problems with the previous version and it introduces some new functionalities in the cwb_gwosc command. It is fully compatible (i.e. in terms of results) with the version used for the latest analyses/results on the LIGO-Virgo data collected during the Third Observing run O3.

• Release Notes

  • Added functionality: GWTC 3 events summary

  • cwb_gwosc command extended to include the latest released events from O3b

  • Minor improvements and fixes

  • Besides the old installation system, based on ad-hoc tailored Makefiles, we are currently testing a cmake installation, which will hopefully make it easier to install cWB. However, although this new feature is already functional, we are still not recommending it as the default installation method.

• Source distribution

  Sources are available on our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.4.1

cWB-6.4.0 - 2020-01-05

• Highlights

  This new release ( cWB-6.4.0 ) is a major upgrade of cWB: it fixes minor problems with the previous version and it introduces some new functionalities in the cwb_gwosc command. It is fully compatible (i.e. in terms of results) with the version used for the latest analyses/results on the LIGO and Virgo data collected during the Third Observing run O3.

• Release Notes

  • Added functionality: GWTC 1-2 events summary

  • cwb_gwosc command extended to include the latest released events from O3a

  • Minor improvements and fixes

• Source distribution

  Sources are available on our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.4.0

cWB-6.3.1 - 2020-03-30

• Highlights

  This new release ( cWB-6.3.1 ) is a minor upgrade of the first public version of cWB ( cWB-6.3.0 ): it fixes minor problems with the previous version and it introduces some new functionalities in the cwb_gwosc command. It is still fully compatible (i.e. in terms of results) with the version ( wat-6.2.6 ) used for the analysis of the LIGO and Virgo data collected during the Second Observational run O2.

• Release Notes

  • cwb_gwosc command: added a simulation mode which uses GWOSC public waveforms from parameter estimation posterior samples.

  • Minor improvements and fixes

• Source distribution

  The entire Git source can be obtained from our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.3.1

cWB-6.3.0 - 2019-04-12

Note

This public release of cWB ( cWB-6.3.0 ) is compatible with the version used for the analysis of O2-RUN data ( wat-6.2.6 ).

• Highlights

  This is the first public version, cWB is now an open source software.

• Release Notes

  • The cWB project has been moved from SVN to GitLab repository

  • Porting from ROOT5 to ROOT6

  • Minor improvements and fixes

• Source distribution

  The entire Git source can be obtained from our public Git repository. The instructions are reported in manual.

  • the library tag is: cWB-6.3.0

  • the config tag is: cWB-6.3.0

Note

The cWB Changelog up to the wat-6.2.6 version used for the O2 analysis is reported in changelog_o2

The LVK repository used for the O3 analysis is https://git.ligo.org/cWB