yall/fullset-f1-repro/README.md

0001 # FullSet F1 reproduction
0002
0003 This example reproduces Fredi's SPS H2 `FullSetF_1` calibration chain from raw
0004 TB2026 data using Yall and HTCondor.
0005
0006 It is a larger validation workflow, not the recommended first Yall/LFHCal test.
0007 For a fresh BNL setup, complete the checks in [`../SETUP.md`](../SETUP.md)
0008 first.
0009
0010 ## Inputs
0011
0012 The workflow uses pedestal run `431` and merges muon runs `426` through `430`
0013 as `Muon_FullSetF_1`.
0014
0015 The raw inputs must be readable as `$LFHCAL_DATA/Run<run>.h2g` for runs
0016 `426 427 428 429 430 431`.
0017
0018 The Yallfile also uses the TB2026 mapping and run database, the FullSetA-F bad
0019 channel map, and the published FullSetF ToA offsets.
0020
0021 Fredi's published reference calibration is:
0022
0023 ```text
0024 calibrations/TB2026/calib_SPS-H2_FullSetF_1.txt
0025 ```
0026
0027 ## Run table and dependencies
0028
0029 The Yallfile declares the six runs once in a typed
0030 `@table runs type run:` table. One `convert-{type}-{run}` family converts every
0031 row. `merge-muon` binds `type=muon`, restricting both its patterned parent
0032 fan-in and `@input.parts` to runs `426`–`430`; pedestal run `431` cannot leak
0033 into the merge.
0034
0035 The `{type}-{run}` pedestal family uses `@each type pedestal`. That explicitly
0036 binds only `type`; the compatible `convert-{type}-{run}` parent supplies the
0037 remaining `run=431`, producing `pedestal-431`. `transfer-f1` depends on the
0038 patterned pedestal family, so changing the pedestal row makes the conversion,
0039 pedestal task, and transfer dependency follow it automatically.
0040
0041 This partial-binding syntax requires yall-run PR #33, merged as commit
0042 `1081e9dd39418262588248272618130ce0503b8a`.
0043
0044 ## Run at BNL
0045
0046 Use the normal BNL `tcsh` login/submit session:
0047
0048 ```tcsh
0049 cd "$LFHCAL_REPO/examples/yall/fullset-f1-repro"
0050 source env.tcsh
0051 foreach r (426 427 428 429 430 431)
0052     ls -lh "$LFHCAL_DATA/Run${r}.h2g"
0053 end
0054 yall-run validate
0055 yall-run plan
0056 set C = `yall-run create --campaigns-dir "$LFHCAL_WORK/campaigns"`
0057 echo "$C"
0058 yall-run start "$C"
0059 yall-run status "$C"
0060 ```
0061
0062 Repeat `yall-run status "$C"` to inspect progress. Do not start a second
0063 campaign against an existing output tree; use a fresh `LFHCAL_WORK` for a clean
0064 rerun.
0065
0066 ## Outputs
0067
0068 Results are written under:
0069
0070 ```text
0071 $LFHCAL_WORK/fullset-f1-repro/
0072 ```
0073
0074 The workflow converts the six raw runs, builds the pedestal calibration, merges
0075 the muon sample, applies bad-channel and ToA information, selects MIP-triggered
0076 events, and performs five refinement passes through `Imp5R`.
0077
0078 Final products are:
0079
0080 ```text
0081 $LFHCAL_WORK/fullset-f1-repro/final/calib_Final_Muon_FullSetF_1.root
0082 $LFHCAL_WORK/fullset-f1-repro/final/calib_Final_Muon_FullSetF_1_calib.txt
0083 ```
0084
0085 `final-f1` does not perform another fit; it copies the `Imp5R` products into the
0086 final output directory.