.. include:: images.rst 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\ :sup:`2`\ ) 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:: |LVK| 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 `_