yall/scan-set-1/README.md

0001 # Parameter scan set 1
0002
0003 This example runs the first TB2026 HGCROC parameter-scan calibration and waveform
0004 analysis through Yall and HTCondor.
0005
0006 For a fresh BNL installation, follow [`../SETUP.md`](../SETUP.md) first. This is
0007 the recommended first production LFHCal workflow after the smoke tests.
0008
0009 ## Run pairs
0010
0011 Pedestal / muon pairs:
0012
0013 ```text
0014 296 / 298
0015 299 / 300
0016 303 / 304
0017 307 / 308
0018 309 / 310
0019 ```
0020
0021 The workflow uses `ToAOffsets_TBSPS2026_ParamScan_1.csv`, the center-2x4 bad
0022 channel map, and `activeCellsHGCROCParameterScan.txt` for the waveform study.
0023
0024 ## Run at BNL
0025
0026 Use the normal BNL `tcsh` login/submit session:
0027
0028 ```tcsh
0029 cd "$LFHCAL_REPO/examples/yall/scan-set-1"
0030 source env.tcsh
0031 foreach r (296 298 299 300 303 304 307 308 309 310)
0032     ls -lh "$LFHCAL_DATA/Run${r}.h2g"
0033 end
0034 yall-run validate
0035 yall-run plan
0036 set C = `yall-run create --campaigns-dir "$LFHCAL_WORK/campaigns"`
0037 echo "$C"
0038 yall-run start "$C"
0039 yall-run status "$C"
0040 ```
0041
0042 Repeat `yall-run status "$C"` to inspect progress. Use a fresh `LFHCAL_WORK` for
0043 a clean rerun rather than targeting an existing output tree.
0044
0045 ## Outputs
0046
0047 Results are written under:
0048
0049 ```text
0050 $LFHCAL_WORK/scan-set-1/
0051 ```
0052
0053 Each pair proceeds through conversion, pedestal extraction, transfer of pedestal
0054 and channel corrections, MIP calibration, MIP-trigger selection, three
0055 refinement passes, calibrated-event production, and the HGCROC waveform study.
0056
0057 Useful final areas are:
0058
0059 ```text
0060 $LFHCAL_WORK/scan-set-1/refine3/
0061 $LFHCAL_WORK/scan-set-1/calibrated/
0062 $LFHCAL_WORK/scan-set-1/waveform/
0063 $LFHCAL_WORK/scan-set-1/plots/
0064 ```
0065
0066 Campaign records and scheduler logs are kept under `$LFHCAL_WORK/campaigns`
0067 when the commands above are used.