How jslawless/run3-mj-analyzer works
This repository is a Run-3 multijet physics-analysis toolkit: users point command-line analyses at ROOT files or dataset JSONs and produce weighted spectra, QA comparisons, and plots. Its workflows cover slimmed-QCD comparisons, evaluator candidate spectra and truth-matched JEC studies, plus mixer hemisphere and assembled-event analyses. The shared runtime layer loads dataset filesets and supplies kinematic observables and truth matching. The README is empty; relationships below are limited to source-index references and excerpted calls, so some script-to-helper links are omitted.
Main entry points: fileset.py Fileset loader · fill_qcd_slimming.py QCD spectra · make_histograms_both_candidates.py Two-candidate spectra · make_stitched_histograms.py Stitched-event spectra
Components 21
Input preparation
- Dataset JSON
scripts/make_dataset_json.py - Dataset manifest builder
scripts/make_dataset_json.py - ROOT dataset merger
scripts/hadd_datasets.py
Spectrum analysis
- QCD spectra
scripts/fill_qcd_slimming.py - Candidate spectra
scripts/make_histograms.py - Two-candidate spectra
scripts/make_histograms_both_candidates.py - Hemisphere spectra
scripts/make_hemisphere_histograms.py - Stitched-event spectra
scripts/make_stitched_histograms.py
Validation and comparison
- QCD slimming comparison
scripts/compare_qcd_slimming.py - Exclusivity checks
scripts/check_exclusivity.py - Truth-matched JEC comparison
scripts/compare_ttbar_mass_jec.py - Slimming comparison
scripts/compare_qcd_slimming.py - Mass-spectrum plots
scripts/plot_mass_spectra.py - Slimmed-spectrum plots
scripts/plot_slimmed_spectra.py
Analysis primitives
- Fileset loader
src/run3_mj_analyzer/fileset.py - Mass asymmetry
src/run3_mj_analyzer/observables.py - Truth matching
src/run3_mj_analyzer/truth_matching.py
Other components
- Slimmed QCD
json_files/slimmed_qcd_lt6_j.json - Evaluator ROOT
json_files/evaluated_qcd.json - ROOT histograms
- Analysis plots
Connections 24
- Dataset manifest builder → Dataset JSON: writes manifest
scripts/make_dataset_json.py - Slimmed QCD → QCD spectra: provides input
- Dataset JSON → QCD spectra: lists datasets
scripts/fill_qcd_slimming.py - QCD spectra → Fileset loader: loads fileset
scripts/fill_qcd_slimming.py - QCD spectra → ROOT histograms: writes spectra
scripts/fill_qcd_slimming.py - QCD slimming comparison → Fileset loader: loads fileset
scripts/compare_qcd_slimming.py - QCD slimming comparison → Analysis plots: writes overlays
scripts/compare_qcd_slimming.py - Candidate spectra → Fileset loader: loads fileset
scripts/make_histograms.py - Candidate spectra → ROOT histograms: writes histograms
scripts/make_histograms.py - Two-candidate spectra → Fileset loader: loads fileset
scripts/make_histograms_both_candidates.py - Two-candidate spectra → Mass asymmetry: uses observable
scripts/make_histograms_both_candidates.py - Two-candidate spectra → ROOT histograms: writes histograms
scripts/make_histograms_both_candidates.py - Hemisphere spectra → Fileset loader: loads fileset
scripts/make_hemisphere_histograms.py - Hemisphere spectra → ROOT histograms: writes histograms
scripts/make_hemisphere_histograms.py - Stitched-event spectra → Fileset loader: loads fileset
scripts/make_stitched_histograms.py - Stitched-event spectra → QCD spectra: reuses binning
scripts/make_stitched_histograms.py - Stitched-event spectra → ROOT histograms: writes histograms
scripts/make_stitched_histograms.py - Exclusivity checks → Fileset loader: uses fileset
scripts/check_exclusivity.py - Truth-matched JEC comparison → Fileset loader: loads fileset
scripts/compare_ttbar_mass_jec.py - Truth-matched JEC comparison → Truth matching: matches truth
scripts/compare_ttbar_mass_jec.py - Truth-matched JEC comparison → ROOT histograms: writes spectra
scripts/compare_ttbar_mass_jec.py - Mass-spectrum plots → Analysis plots: produces plots
- Slimmed-spectrum plots → Analysis plots: produces plots
- ROOT dataset merger → ROOT histograms: merges files