How ksl111/new_analysis_code works
This repository is a Run-3 CMS NanoAOD analysis pipeline: users select datasets and regions, the Python runner reads events, applies object selection, corrections, triggers and region cuts, then produces histograms and cutflows for plotting and datacard generation. Supporting branches manage dataset bookkeeping, derive/apply pT(ll) weights, and validate corrections. The README describes a C++ ROOT event-loop core, but the only C++ files present are in attic and the entry point is explicitly a stub; active runtime wiring is therefore represented by the Python runners. Arrows cite shown imports or README statements; unsampled relationships are omitted.
Main entry points: run_analysis.py Analysis runner · run_analysis_all.py Multi-region runner · dataset_list.py Dataset catalog · io.py NanoAOD I/O
Components 24
Event analysis
- Analysis runner
run_analysis.py - Multi-region runner
run_analysis_all.py
Selection and observables
- Object building
python/analysis/objects.py - Lepton utilities
python/analysis/leptons.py - Trigger selection
python/analysis/triggers.py - Region cuts
python/analysis/regions.py - Event weights
python/analysis/weights.py - Histograms
python/analysis/histograms.py
Data and corrections
- NanoAOD I/O
python/common/io.py - Dataset catalog
python/bookkeeping/dataset_list.py - Muon correction
python/corrections/muonscare.py - MET XY correction
python/corrections/metxy_apply.py - pT(ll) reweighting
python/corrections/ptll_weight.py - pT(ll) derivation
python/corrections/ptll_derive.py - Chunk planning
python/bookkeeping/make_chunks.py - Sum-weight bookkeeping
python/bookkeeping/compute_sumw.py
Results and validation
- Chunk merging
python/postproc/merge_chunks.py - Data/MC plots
python/postproc/plot_data_mc_all.py - Combine datacard
python/postproc/make_datacard.py - Correction validation
python/validation/validate_metxy.py - Muon validation
python/validation/validate_muonscare.py - Histogram outputs
Other components
- Analyst
- NanoAOD files
Connections 38
- Analyst → Analysis runner: starts analysis
run_analysis.py - Analyst → Multi-region runner: starts analysis
run_analysis_all.py - NanoAOD files → NanoAOD I/O: provides events
python/common/io.py - Analysis runner → NanoAOD I/O: reads inputs
run_analysis.py - Analysis runner → Dataset catalog: selects datasets
run_analysis.py - Analysis runner → Object building: builds objects
run_analysis.py - Analysis runner → Lepton utilities: uses lepton helpers
run_analysis.py - Analysis runner → Trigger selection: applies triggers
run_analysis.py - Analysis runner → Region cuts: applies region cuts
run_analysis.py - Analysis runner → Event weights: computes weights
run_analysis.py - Analysis runner → Histograms: fills histograms
run_analysis.py - Analysis runner → Muon correction: applies correction
run_analysis.py - Analysis runner → MET XY correction: applies correction
run_analysis.py - Analysis runner → pT(ll) reweighting: applies reweighting
run_analysis.py - Multi-region runner → Object building: builds objects
run_analysis_all.py - Multi-region runner → Region cuts: applies region cuts
run_analysis_all.py - Multi-region runner → Histograms: fills histograms
run_analysis_all.py - Multi-region runner → MET XY correction: applies correction
run_analysis_all.py - Multi-region runner → pT(ll) reweighting: applies reweighting
run_analysis_all.py - Analysis runner → Histogram outputs: writes results
- Multi-region runner → Histogram outputs: writes results
- Dataset catalog → Chunk planning: plans chunks
python/bookkeeping/make_chunks.py - NanoAOD I/O → Sum-weight bookkeeping: reads Runs tree
python/bookkeeping/compute_sumw.py - Histogram outputs → Chunk merging: merges chunks
python/postproc/merge_chunks.py - Dataset catalog → Chunk merging: selects datasets
python/postproc/merge_chunks.py - Histogram outputs → Data/MC plots: plots histograms
python/postproc/plot_data_mc_all.py - Dataset catalog → Data/MC plots: labels samples
python/postproc/plot_data_mc_all.py - Histograms → Data/MC plots: defines histogram format
python/postproc/plot_data_mc_all.py - Histogram outputs → Combine datacard: reads yields
python/postproc/make_datacard.py - Dataset catalog → Combine datacard: labels samples
python/postproc/make_datacard.py - Histograms → Combine datacard: uses histogram definitions
python/postproc/make_datacard.py - Histogram outputs → pT(ll) derivation: supplies distributions
- Dataset catalog → pT(ll) derivation: selects samples
python/corrections/ptll_derive.py - pT(ll) derivation → pT(ll) reweighting: derives reweighting
- Analyst → Correction validation: runs validation
python/validation/validate_metxy.py - NanoAOD I/O → Correction validation: reads input files
python/validation/validate_metxy.py - Analyst → Muon validation: runs validation
python/validation/validate_muonscare.py - NanoAOD I/O → Muon validation: reads input files
python/validation/validate_muonscare.py