How jeffersonlab/sbs-replay works
SBS-replay is a toolkit for replaying SBS detector data and analyzing or calibrating the resulting ROOT data. The principal workflow is replay configuration of the analyzer, followed by detector-specific post-processing and analysis; calibration and plotting are separate analysis branches rather than a single pipeline. The repository also includes a crate-map conversion utility and HCal control and event-display interfaces. Relationships among sampled modules are cited where visible; broader subsystem capabilities and the replay-to-analysis handoff follow the README, since most scripts were not sampled.
Main entry points: replay Replay configurations · make_sbssim_cratemap.py Crate-map conversion · TOFcal_consolidated.C Hodoscope timing · ECAL_HCAL_calib_parsed_output.C ECAL-HCAL calibration
Components 24
Data replay
- Replay configurations
replay - Crate-map conversion
DB/make_sbssim_cratemap.py
Detector calibration
- Hodoscope timing
scripts/hodo/TOFcal_consolidated.C - Hodoscope tree reader
scripts/hodo/gmn_tree.C - ECAL-HCAL calibration
scripts/ecal/ECAL_HCAL_calib_parsed_output.C - Parsed GEP tree
scripts/ecal/gep_tree_parsed.C - GEM calibration
scripts/gems - HCAL calibration
scripts/hcal - BBCal calibration
scripts/bbcal
Physics analysis
- Beam analysis
scripts/beam - BigBite optics fit
scripts/optics/Optics_BigBite_automatic.C - Optics tree reader
scripts/optics/gmn_tree.C - HCAL N/P uniformity
scripts/misc/HCAL_np_ratio_uniformity.C - Elastic tree reader
scripts/misc/gmn_elastic_tree.C - ECAL shower profiles
scripts/ecal/ECAL_shower_profiles.C - BBCal quality plots
scripts/qa/qualityA_plots_BBCAL.C - Online monitoring plots
onlineGUIconfig/scripts - Histogram overlays
onlineGUIconfig/scripts/overlay.C
Detector operations
- HCal control and display
scripts/hcal/GUI - GRINCH monitoring
scripts/grinch
Other components
- Analyst
- CODA data
- Hall A analyzer
- ROOT output
Connections 24
- Analyst → Replay configurations: selects run
- CODA data → Hall A analyzer: provides events
- Replay configurations → Hall A analyzer: configures and runs
- Hall A analyzer → ROOT output: writes results
- Analyst → Crate-map conversion: runs conversion
- Crate-map conversion → CODA data: reads crate map
DB/make_sbssim_cratemap.py - ROOT output → Hodoscope timing: provides input
- Hodoscope timing → Hodoscope tree reader: uses reader
scripts/hodo/TOFcal_consolidated.C - ROOT output → ECAL-HCAL calibration: provides input
- ECAL-HCAL calibration → Parsed GEP tree: uses reader
scripts/ecal/ECAL_HCAL_calib_parsed_output.C - ROOT output → GEM calibration: provides input
- ROOT output → HCAL calibration: provides input
- ROOT output → BBCal calibration: provides input
- ROOT output → Beam analysis: provides input
- ROOT output → BigBite optics fit: provides input
- BigBite optics fit → Optics tree reader: uses reader
scripts/optics/Optics_BigBite_automatic.C - ROOT output → HCAL N/P uniformity: provides input
- HCAL N/P uniformity → Elastic tree reader: uses reader
scripts/misc/HCAL_np_ratio_uniformity.C - ROOT output → ECAL shower profiles: provides input
- ROOT output → BBCal quality plots: provides input
- ROOT output → Online monitoring plots: provides input
- Online monitoring plots → Histogram overlays: calls overlay
onlineGUIconfig/scripts/bbcal_corr_plots.C - Analyst → HCal control and display: uses interface
- Analyst → GRINCH monitoring: runs monitoring