JetsAndHF/JetValidation/README.md

0001 # Jet Macro For Validation
0002
0003 **Last update:** 07.01.2026, DMA
0004
0005 ### Shell Used and Usage
0006 ------------------------
0007
0008 Utilized eic-shell version `26.05.0-stable` for testing. Macro can be run
0009 directly in eic-shell with:
0010 ```bash
0011 root -b -q JetValidation.C
0012 ```
0013
0014 And can be run via slurm (e.g. at the JLab ifarm) with after updating
0015 options in script:
0016 ```bash
0017 sbatch SubmitJetValidationToSlurm.sh
0018 ```
0019
0020 ### Files Used
0021 --------------
0022
0023 Performed two tests: one before we switched the jet reconstruction output to
0024 `edm4eic::Jet` (26.05.0) and one after (26.06.0).
0025
0026 #### 26.05.0
0027
0028 Utilized 26.05.0 Pythia8 NC DIS 10x100 (q2 = 100 - 1K) dataset for before test:
0029
0030 ```bash
0031 rucio did content list epic:/RECO/26.05.0/epic_craterlake/DIS/pythia8.316-1.0/NC/noRad/ep/10x100/q2_100to1000
0032 ```
0033
0034 Complete filelist saved to `filelists/files26050.py8ncdis10x100q100t1000.list`.  Ran two tests:
0035   - One using only 1 file (`*_run000.0000.*`) and saved outputs to
0036     `examples/plots.26050_run000_0000to0000.tar.gz`.
0037   - One using first 1K files (`*_run000.0{000-999}.*`) and saved outputs to
0038     `examples/plots.26050_run000_0000to0999.tar.gz`.
0039
0040 #### 26.06.0
0041
0042 Utilized 26.06.0 Pythia8 NC DIS 10x100 (q2 = 100 - 1K) dataset for after test:
0043
0044 ```bash
0045 rucio did content list epic:/RECO/26.06.0/epic_craterlake/DIS/pythia8.316-1.0/NC/noRad/ep/10x100/q2_100to1000
0046 ```
0047
0048 Complete filelist saved to `filelists/files26060.py8ncdis10x100q100t1000.list`.  Ran two tests:
0049   - One using only 1 file (`*_run000.0000.*`) and saved outputs to
0050     `examples/plots.26060_run000_0000to0000.tar.gz`.
0051   - One using first 1K files (`*_run000.0{000-999}.*`) and saved outputs to
0052     `examples/plots.26060_run000_0000to0999.tar.gz`.
0053
0054 ### Plot File Names and Titles
0055 ------------------------------
0056
0057 These tables list the plot names and their titles which might be be best for Hydra.
0058 Some (such as the resolution fit summaries) likely won't render well on the web. The
0059 order of entries reflects the order which might be good to display on the web.
0060
0061 **Note:** the area plots won't appear if you're running on a campaign prior to 26.06.0.
0062
0063 #### Reconstructed Jets
0064
0065 | File Name | Title |
0066 | --------- | ----- |
0067 | numberRecoJets.png | Number of Charged Jets per Event (Reconstruction Level) |
0068 | numberConstituentPerRecoJet.png | Number of Constituents per Charged Jet (Reconstruction Level) |
0069 | recoJetEnergy.png | Charged Jet Energy ($\|\eta\|$ < 2.5, Reconstruction Level) |
0070 | recoJetEta.png | Charged Jet $\eta$ ($E_{jet}$ > 5 GeV, Reconstruction Level) |
0071 | recoJetEnergyVsArea.png | Charged Jet Energy vs. Area (Reconstruction Level) |
0072 | recoJetEnergyVsEta.png | Charged Jet Energy vs. $\eta$ (With $e^{-}$, Reconstruction Level) |
0073 | recoJetEnergyVsEtaNoElectron.png | Charged Jet Energy vs. $\eta$ (No $e^{-}$, Reconstruction Level) |
0074 | recoJetEnergyVsArea.png | Charged Jet Energy vs. Area (Reconstruction Level) |
0075 | recoJetPhiVsEta.png | Charged Jet $\varphi$ vs. $\eta$ (With $e^{-}$, $E_{jet}$ > 5 GeV, Reconstruction Level) |
0076 | recoJetPhiVsEtaNoElectron.png | Charged Jet $\varphi$ vs. $\eta$ (No $e^{-}$, $E_{jet}$ > 5 GeV, Reconstruction Level) |
0077 | recoJetConstituent.png | Charged Constituent $\eta$ (Reconstruction Level) |
0078 | recoJetConstituentMomentum.png | Charged Constituent Momenta (Reconstruction Level) |
0079 | recoJetConstituentMomentumVsEta.png | Charged Constituent Momenta vs. $\eta$ (With $e^{-}$, Reconstruction Level) |
0080 | recoJetConstituentMomentumVsEtaNoElectron.png | Charged Constituent Momenta vs. $\eta$ (No $e^{-}$, Reconstruction Level) |
0081 | recoJetConstituentPairwiseDR.png | Pairwise Charged Constituent $\Delta R$ (Reconstruction Level) |
0082 | recoJetConstituentPhiVsEta.png | Jet Constituent $\varphi$ vs. $\eta$ (With $e^{-}$, Reconstruction Level) |
0083 | recoJetConstituentPhiVsEtaNoElectron.png | Jet Constituent $\varphi$ vs. $\eta$ (No $e^{-}$, Reconstruction Level) |
0084
0085 #### Generated Jets
0086
0087 | File Name | Title |
0088 | --------- | ----- |
0089 | numberGenJets.png | Number of Charged Jets per Event (Generator Level) |
0090 | numberConstituentPerGenJet.png | Number of Constituents per Charged Jet (Generator Level) |
0091 | genJetEnergy.png | Charged Jet Energy ($\|\eta\|$ < 2.5, Generator Level) |
0092 | genJetEta.png | Charged Jet $\eta$ ($E_{jet}$ > 5 GeV, Generator Level) |
0093 | genJetAea.png | Charged Jet Area ($E_{jet}$ > 5 GeV, Generator Level) |
0094 | genJetEnergyVsEta.png | Charged Jet Energy vs. $\eta$ (With $e^{-}$, Generator Level) |
0095 | genJetEnergyVsEtaNoElectron.png | Charged Jet Energy vs. $\eta$ (No $e^{-}$, Generator Level) |
0096 | genJetPhiVsEta.png | Charged Jet $\varphi$ vs. $\eta$ (With $e^{-}$, $E_{jet}$ > 5 GeV, Generator Level) |
0097 | genJetPhiVsEtaNoElectron.png | Charged Jet $\varphi$ vs. $\eta$ (No $e^{-}$, $E_{jet}$ > 5 GeV, Generator Level) |
0098 | genJetEnergyVsArea.png | Charged Jet Energy vs. Area (Generator Level) |
0099 | genJetConstituent.png | Charged Constituent $\eta$ (Generator Level) |
0100 | genJetConstituentMomentum.png | Charged Constituent Momenta (Generator Level) |
0101 | genJetConstituentMomentumVsEta.png | Charged Constituent Momenta vs. $\eta$ (With $e^{-}$, Generator Level) |
0102 | genJetConstituentMomentumVsEtaNoElectron.png | Charged Constituent Momenta vs. $\eta$ (No $e^{-}$, Generator Level) |
0103 | genJetConstituentPairwiseDR.png | Pairwise Charged Constituent $\Delta R$ (Generator Level) |
0104 | genJetConstituentPhiVsEta.png | Jet Constituent $\varphi$ vs. $\eta$ (With $e^{-}$, Generator Level) |
0105 | genJetConstituentPhiVsEtaNoElectron.png | Jet Constituent $\varphi$ vs. $\eta$ (No $e^{-}$, Generator Level) |
0106
0107 #### Generated vs. Reconstructed Jets
0108
0109 | File Name | Title |
0110 | --------- | ----- |
0111 | genRecoJetDeltaR.png | $\Delta R$ Between Generated and Reconstructed Charged Jet Matches |
0112 | matchedJetScaleResolutionSummary.png | Charged Jet Energy Resolution and Scale vs. $\eta$ |
0113 | matchedJetResolutionVsEnergy.png | Charged Jet Energy Resolution vs. Generated Jet Energy (All $\eta$) |
0114 | matchedJetResolutionVsEta.png | Charged Jet Energy Resolution vs. Generated Jet $\eta$ |
0115 | matchedJetResolutionVsEnergyMidEta.png | Central Charged Jet Energy Resolution vs. Generated Jet Energy ($|\eta|$ < 1) |
0116 | matchedJetResolutionVsEnergyNegEta.png | Backward Charged Jet Energy Resolution vs. Generated Jet Energy ($\eta \in (-2,5, -1.0)) |
0117 | matchedJetResolutionVsEnergyPosEta.png | Forward Charged Jet Energy Resolution vs. Generated Jet Energy ($\eta \in (1.0, 2.5)) |
0118 | matchedRecoVsGenJetEnergy.png | Reconstructed vs. Generated Charged Jet Energy |
0119 | matchedRecoVsGenJetEta.png | Reconstructed vs. Generated Charged Jet $\eta$ |
0120 | matchedRecoVsGenJetPhi.png | Reconstructed vs. Generated Charged jet $\varphi$ |
0121 | matchedRecoVsGenJetArea.png | Reconstructed vs. Generated Charged Jet Area |