yall/fullset-g2-repro/README.md

0001 # FullSet G2 reproduction
0002
0003 This example reproduces Fredi's SPS H2 `FullSetG_2` calibration chain from raw
0004 TB2026 data using Yall and HTCondor.
0005
0006 ## Inputs
0007
0008 FullSet G2 uses pedestal run `529` and merges muon runs
0009
0010 ```text
0011 530 531 532 533 534 535 536 537
0012 ```
0013
0014 as `Muon_FullSetG_2`.
0015
0016 It is the later repeat of the FullSet G muon calibration.  Like G1, it uses:
0017
0018 - the V1 summing-board mapping
0019 - `badChannel_HGCROC_SPSTB2026_FullSetG.txt`
0020 - `ToAOffsets_TBSPS2026_FullSetG.csv`
0021
0022 The published reference calibration is:
0023
0024 ```text
0025 calibrations/TB2026/calib_SPS-H2_FullSetG_2.txt
0026 ```
0027
0028 ## Download the raw files at BNL
0029
0030 From this example directory:
0031
0032 ```tcsh
0033 tcsh download_raw.tcsh
0034 ```
0035
0036 The script downloads runs 529 through 537 to `$LFHCAL_DATA` when that
0037 environment variable is set.  If it is not set, Paul's standard TB2026 PWG
0038 directory is used.  An explicit destination can also be supplied:
0039
0040 ```tcsh
0041 tcsh download_raw.tcsh /path/to/raw-data
0042 ```
0043
0044 Existing nonempty raw files are left alone.  A download is first written to a
0045 `.part` file and renamed only after `xrdcp` succeeds.
0046
0047 ## Run at BNL
0048
0049 Use the bootstrapped LFHCal workspace checkout:
0050
0051 ```tcsh
0052 cd "$LFHCAL_REPO/examples/yall/fullset-g2-repro"
0053 source env.tcsh
0054
0055 yall-run validate
0056 yall-run plan
0057
0058 set C = `yall-run create --campaigns-dir "$LFHCAL_WORK/campaigns"`
0059 echo "$C"
0060 yall-run start "$C"
0061 yall-run status "$C"
0062 ```
0063
0064 The run table is declared once:
0065
0066 ```text
0067 @table runs type run:
0068     pedestal 529
0069     muon     530
0070     muon     531
0071     muon     532
0072     muon     533
0073     muon     534
0074     muon     535
0075     muon     536
0076     muon     537
0077 ```
0078
0079 The partial-binding pedestal rule inherits `run=529` from the compatible
0080 conversion row, while `merge-muon` fans in only the eight muon conversion
0081 tasks.
0082
0083 Results are written under:
0084
0085 ```text
0086 $LFHCAL_WORK/fullset-g2-repro/
0087 ```
0088
0089 with final products:
0090
0091 ```text
0092 $LFHCAL_WORK/fullset-g2-repro/final/calib_Final_Muon_FullSetG_2.root
0093 $LFHCAL_WORK/fullset-g2-repro/final/calib_Final_Muon_FullSetG_2_calib.txt
0094 ```