v3.0.0

⚠️ Breaking Changes ⚠️

🟢 QADB Constructor change

The QADB constructor (both C++ and Groovy versions) now require a string argument, cook:

// new version (v3)
QADB(std::string const& cook, int runnumMin_ = -1, int runnumMax = -1, bool verbose_ = false);

// old version (v2 and v1)
QADB(int runnumMin_ = -1, int runnumMax = -1, bool verbose_ = false);

This cook argument may be:

• "latest": use the latest available DB (highest Pass number); see the main README.md for details
• "pass1": use Pass 1 only
• "pass2": use Pass 2 only (if available; as of this release, only RG-A Fall 2018 has a Pass 2 and a Pass 1)

Note: this version is not compatible with clas12root version 1.8.4a and earlier.

Associated pull request: #52

🟢 Removal of text/ files

We have removed the text tables in text/, which have become practically useless with the introduction of new defect bits. See #55 for details.

🏗️ Other Changes 🏗️

• feat: RG-A Spring 2019 Pass 2 QA by @c-dilks in #51
• ci: update actions' versions by @c-dilks in #53
• feat: enable Dependabot for GitHub actions by @c-dilks in #54

Full Changelog: v2.0.0...v3.0.0

QADB 2.0.0

The major version has been increased from v1 to v2, since new QADB databases will provide QA results per "time bin", rather than per DST 5-file; this change is from upstream (clas12-timeline), and no change to the API here has occurred. Several new defect bits have been defined as well. At the moment, only RG-C Summer 2022 (rgc_su22) uses time bins and the new defect bits.

We have deprecated the common criteria sets OkForAsymmetry and Golden, and provided guidance for the preferred method. See #50 for details.

We also plan to deprecate the QADB reader code here (QADB.groovy and QADB.h), in favor of an Iguana algorithm, since this reader code is not thread safe, and is repeated in two different languages.

Primary Changes

• feat: RG-C Summer 2022 QADB by @c-dilks in #49
• feat: deprecate OkForAsymmetry and Golden, and provide guidance for their replacement by @c-dilks in #50

Additional Changes

• doc: consistent defect bit descriptions by @c-dilks in #44
• fix: source tsch environment file from anywhere by @c-dilks in #45
• feat: calculate gap and overlapping charge from Pass 1 QADB by @c-dilks in #47

Full Changelog: v1.3.0...v2.0.0

QADB 1.3.0

New QADB version with Run Group M included from the work of @esteejus

What's Changed

• doc: clarify timeline production code by @c-dilks in #25
• ci: update actions to v3 by @c-dilks in #26
• fix: respect rename clasqaDB -> clas12-qadb by @c-dilks in #29
• doc: add table of available datasets by @c-dilks in #32
• ci: use groovy v4 by @c-dilks in #35
• fix: rename env.sh -> environ.sh by @c-dilks in #36
• fix: trigger CI on pushes to main, not master by @c-dilks in #37
• refactor: consistent data set names by @c-dilks in #34
• ci: cancel in-progress workflows upon new PR commit by @c-dilks in #38
• doc: add timeline links by @c-dilks in #39
• doc: fix spelling by @c-dilks in #40
• doc: small fixes by @c-dilks in #42
• ci: automatically get list of datasets to check by @c-dilks in #43
• feat: add RG-M QA results by @c-dilks in #41

Full Changelog: v1.2.2...v1.3.0

QADB 1.2.2

What's Changed

• remove rgk_7 runs with no charge from qaTree.json in #19
• add CI tests, to check consistency between C++ and Groovy APIs in #16
• add QA criteria result summary file in #23
• update RGA Fall2018 QADB, from Sangbaek #20

Full Changelog: v1.2.1...v1.2.2

QADB 1.2.1

Document FADC failure in RGA spring 19 dataset
See #6 (PR #8)

QADB 1.2.0

Add Forward Tagger (FT) defect bits

QADB 1.1.1

Add RGB Winter 2020 QADB

QADB release 1.1.0

Fixes issue in C++ QADB class. This class is header only, and functions were not defined inline, leading to multiple definitions errors. All functions are now inline, and a new namespace QA was created.

Impact: Users of the C++ QADB class will need to update their code, specifying the QA namespace.

QADB release 1.0.1

Fixes bug in Groovy QADB class: sectorDefect was the incorrect type, causing a typecast crash. No change to C++ implementation

QADB release 1.0.0

First version with C++ and groovy classes completely synchronized, along with access to FC charge.