evsel docs: make EventSelectionFlags enum up-to-date

Author: altsybee

docs/analysis-tools/EventSelection.md

@@ -161,42 +161,58 @@ Full list of event selection criteria can be found in [`Common/CCDB/EventSelecti
 
 ``` c++
 enum EventSelectionFlags {
-  kIsBBV0A = 0,        // cell-averaged time in V0A in beam-beam window
-  kIsBBV0C,            // cell-averaged time in V0C in beam-beam window (for Run 2 only)
-  kIsBBFDA,            // cell-averaged time in FDA (or AD in Run2) in beam-beam window
-  kIsBBFDC,            // cell-averaged time in FDC (or AD in Run2) in beam-beam window
-  kIsBBT0A,            // cell-averaged time in T0A in beam-beam window
-  kIsBBT0C,            // cell-averaged time in T0C in beam-beam window
-  kNoBGV0A,            // cell-averaged time in V0A in beam-gas window
-  kNoBGV0C,            // cell-averaged time in V0C in beam-gas window (for Run 2 only)
-  kNoBGFDA,            // cell-averaged time in FDA (AD in Run2) in beam-gas window
-  kNoBGFDC,            // cell-averaged time in FDC (AD in Run2) in beam-gas window
-  kNoBGT0A,            // cell-averaged time in T0A in beam-gas window
-  kNoBGT0C,            // cell-averaged time in T0C in beam-gas window
-  kIsBBZNA,            // time in common ZNA channel in beam-beam window
-  kIsBBZNC,            // time in common ZNC channel in beam-beam window
-  kIsBBZAC,            // time in ZNA and ZNC in beam-beam window - circular cut in ZNA-ZNC plane
-  kNoBGZNA,            // time in common ZNA channel is outside of beam-gas window
-  kNoBGZNC,            // time in common ZNC channel is outside of beam-gas window
-  kNoV0MOnVsOfPileup,  // no out-of-bunch pileup according to online-vs-offline VOM correlation
-  kNoSPDOnVsOfPileup,  // no out-of-bunch pileup according to online-vs-offline SPD correlation
-  kNoV0Casymmetry,     // no beam-gas according to correlation of V0C multiplicities in V0C3 and V0C012
-  kIsGoodTimeRange,    // good time range
-  kNoIncompleteDAQ,    // complete event according to DAQ flags
-  kNoTPCLaserWarmUp,   // no TPC laser warm-up event (used in Run 1)
-  kNoTPCHVdip,         // no TPC HV dip
-  kNoPileupFromSPD,    // no pileup according to SPD vertexer
-  kNoV0PFPileup,       // no out-of-bunch pileup according to V0 past-future info
-  kNoSPDClsVsTklBG,    // no beam-gas according to cluster-vs-tracklet correlation
-  kNoV0C012vsTklBG,    // no beam-gas according to V0C012-vs-tracklet correlation
-  kNoInconsistentVtx,  // no inconsistency in SPD and Track vertices
-  kNoPileupInMultBins, // no pileup according to multiplicity-differential pileup checks
-  kNoPileupMV,         // no pileup according to multi-vertexer
-  kNoPileupTPC,        // no pileup in TPC
-  kIsTriggerTVX,       // FT0 vertex (acceptable FT0C-FT0A time difference) at trigger level
-  kIsINT1,             // SPDGFO >= 1 || V0A || V0C
-  kNsel                // counter
-};
+  kIsBBV0A = 0,               // cell-averaged time in V0A in beam-beam window
+  kIsBBV0C,                   // cell-averaged time in V0C in beam-beam window (for Run 2 only)
+  kIsBBFDA,                   // cell-averaged time in FDA (or AD in Run2) in beam-beam window
+  kIsBBFDC,                   // cell-averaged time in FDC (or AD in Run2) in beam-beam window
+  kIsBBT0A,                   // cell-averaged time in T0A in beam-beam window
+  kIsBBT0C,                   // cell-averaged time in T0C in beam-beam window
+  kNoBGV0A,                   // cell-averaged time in V0A in beam-gas window
+  kNoBGV0C,                   // cell-averaged time in V0C in beam-gas window (for Run 2 only)
+  kNoBGFDA,                   // cell-averaged time in FDA (AD in Run2) in beam-gas window
+  kNoBGFDC,                   // cell-averaged time in FDC (AD in Run2) in beam-gas window
+  kNoBGT0A,                   // cell-averaged time in T0A in beam-gas window
+  kNoBGT0C,                   // cell-averaged time in T0C in beam-gas window
+  kIsBBZNA,                   // time in common ZNA channel in beam-beam window
+  kIsBBZNC,                   // time in common ZNC channel in beam-beam window
+  kIsBBZAC,                   // time in ZNA and ZNC in beam-beam window - circular cut in ZNA-ZNC plane
+  kNoBGZNA,                   // time in common ZNA channel is outside of beam-gas window
+  kNoBGZNC,                   // time in common ZNC channel is outside of beam-gas window
+  kNoV0MOnVsOfPileup,         // no out-of-bunch pileup according to online-vs-offline VOM correlation
+  kNoSPDOnVsOfPileup,         // no out-of-bunch pileup according to online-vs-offline SPD correlation
+  kNoV0Casymmetry,            // no beam-gas according to correlation of V0C multiplicities in V0C3 and V0C012
+  kIsGoodTimeRange,           // good time range
+  kNoIncompleteDAQ,           // complete event according to DAQ flags
+  kNoTPCLaserWarmUp,          // no TPC laser warm-up event (used in Run 1)
+  kNoTPCHVdip,                // no TPC HV dip
+  kNoPileupFromSPD,           // no pileup according to SPD vertexer
+  kNoV0PFPileup,              // no out-of-bunch pileup according to V0 past-future info
+  kNoSPDClsVsTklBG,           // no beam-gas according to cluster-vs-tracklet correlation
+  kNoV0C012vsTklBG,           // no beam-gas according to V0C012-vs-tracklet correlation
+  kNoInconsistentVtx,         // no inconsistency in SPD and Track vertices
+  kNoPileupInMultBins,        // no pileup according to multiplicity-differential pileup checks
+  kNoPileupMV,                // no pileup according to multi-vertexer
+  kNoPileupTPC,               // no pileup in TPC
+  kIsTriggerTVX,              // FT0 vertex (acceptable FT0C-FT0A time difference) at trigger level
+  kIsINT1,                    // SPDGFO >= 1 || V0A || V0C
+  kNoITSROFrameBorder,        // bunch crossing is far from ITS RO Frame border
+  kNoTimeFrameBorder,         // bunch crossing is far from Time Frame borders
+  kNoSameBunchPileup,         // reject collisions in case of pileup with another collision in the same foundBC
+  kIsGoodZvtxFT0vsPV,         // small difference between z-vertex from PV and from FT0
+  kIsVertexITSTPC,            // at least one ITS-TPC track (reject vertices built from ITS-only tracks)
+  kIsVertexTOFmatched,        // at least one of vertex contributors is matched to TOF
+  kIsVertexTRDmatched,        // at least one of vertex contributors is matched to TRD
+  kNoCollInTimeRangeNarrow,   // no other collisions in specified time range (narrower than Strict)
+  kNoCollInTimeRangeStrict,   // no other collisions in specified time range
+  kNoCollInTimeRangeStandard, // no other collisions in specified time range with per-collision multiplicity above threshold
+  kNoCollInRofStrict,         // no other collisions in this Readout Frame
+  kNoCollInRofStandard,       // no other collisions in this Readout Frame with per-collision multiplicity above threshold
+  kNoHighMultCollInPrevRof,   // veto an event if FT0C amplitude in previous ITS ROF is above threshold
+  kIsGoodITSLayer3,           // number of inactive chips on ITS layer 3 is below maximum allowed value
+  kIsGoodITSLayer0123,        // numbers of inactive chips on ITS layers 0-3 are below maximum allowed values
+  kIsGoodITSLayersAll,        // numbers of inactive chips on all ITS layers are below maximum allowed values
+  kNsel                       // counter
+}; // (as of October 2025)
 ```
 
 Technically there are three types of criteria:
@@ -398,7 +414,7 @@ Additional effect happens at the **beginning of the next TF**, when the reconstr
 - The effect is **particle-dependent**, e.g. protons (larger dE/dx) are recorded earlier than pions—leading to small PID-dependent distortions near borders.
 
 **Mitigation in event selection**
-- The selection bit **`kNoITSROFrameBorder`** rejects events near ITS ROF edges:
+- The selection bit `kNoITSROFrameBorder` rejects events near ITS ROF edges:
   - removes collisions within  **10 BCs** at the beginning and **20 BCs** at the end of each ROF
   - it correponds to ≈ 15 % of BCs in pp and ≈5 % of BCs in Pb–Pb (corresponding event losses depend on the LHC filling scheme)
 - Usage in analysis: