feat: streamline access to beam energy

report/README.md

@@ -0,0 +1,54 @@
+# Beam Energy Cross Check
+
+This is a summary of the differences between the hard-coded beam energies in the timeline code and the RCDB.
+See other files in this directory, in case there are typos here:
+- `*.yaml` contain the hard-coded beam energies, extracted from scripts (see comment within)
+- `diff-*.txt` shows all differences between hard-coded beam energies and those from RCDB;
+  run `run_validate.sh` to produce these files
+
+Only differences greater than 0.01 GeV are noted.
+
+In the timeline code, beam energy is used for plot ranges (and occasionally cuts) for the detector timelines, and for (SI)DIS kinematics and cuts for beam spin asymmetries in the physics timelines.
+
+## RG-A
+- RCDB matches timeline hard-coded values
+
+## RG-B
+- 11323-11391
+  - timeline hard-coded: 10.3894 GeV
+  - RCDB: 10.2129 GeV
+
+## RG-C
+- 16079
+  - timeline hard-coded: 2.22 GeV
+  - RCDB: 10.5473 GeV
+- 17067-18130
+  - timeline hard-coded: 10.54 GeV
+  - RCDB: 10.5563 GeV up to run 17716 and 10.5593 GeV thereafter
+    - for runs 17411, 17412 (empty target runs), and 18086 (cosmics) RCDB says -9.999 GeV
+
+## RG-F
+- 11620-11656
+  - timeline hard-coded: 2.182 GeV
+  - RCDB: 2.14418 GeV
+  - **not in QADB**
+- 11657
+  - timeline hard-coded: 2.182 GeV
+  - RCDB: 10.3894 GeV
+  - **not in QADB**
+- 12444
+  - detector timelines use 2.182 GeV
+  - physics timelines use 10.389 GeV
+  - RCDB: 10.1966 GeV
+- 12447-12951
+  - timelines say: 10.389 GeV
+  - RCDB: various differing values from about 10.2 to 10.4
+
+## RG-K
+- 5985-5990: 
+  - timeline hard-coded: 6.535 GeV
+  - RCDB: 6.500 GeV
+  - this is a small difference, and nothing is noted about this in log book; should we correct RCDB?
+
+## RG-M
+- RCDB matches timeline hard-coded values

report/beam-energy-mon.yaml

@@ -0,0 +1,39 @@
+# hard-coded beam energies from bin/slurm-mon12.sh
+beamEnergy:
+  A:
+    - runnum: [ 3861, 5673 ]
+      value: 10.6
+    - runnum: [ 6608, 6783 ]
+      value: 10.199
+
+  K:
+    - runnum: [ 5674, 5870 ]
+      value: 7.546
+    - runnum: [ 5871, 6000 ]
+      value: 6.535
+
+  F:
+    - runnum: [ 11620, 11657 ] # not sure if actually RG-F
+      value: 2.182
+    - runnum: [ 11658, 12283 ]
+      value: 10.389
+    - runnum: [ 12389, 12444 ]
+      value: 2.182
+    - runnum: [ 12445, 12951 ]
+      value: 10.389
+
+  M:
+    - runnum: [ 15013, 15490 ]
+      value: 5.98636
+    - runnum: [ 15533, 15727 ]
+      value: 2.07052
+    - runnum: [ 15728, 15784 ]
+      value: 4.02962
+    - runnum: [ 15787, 15884 ]
+      value: 5.98636
+
+  C:
+    - runnum: [ 16010, 16079 ] # not sure if actually RG-C
+      value: 2.22
+    - runnum: [ 16084, 20000 ]
+      value: 10.54

report/beam-energy-qa.yaml

@@ -0,0 +1,48 @@
+# hard-coded beam energies from qa-physics/monitorRead.groovy
+beamEnergy:
+
+  A:
+    - runnum: [ 4763, 5001 ]
+      value: 10.6041
+    - runnum: [ 5032, 5262 ]
+      value: 10.6041
+    - runnum: [ 5300, 5666 ]
+      value: 10.6041
+    - runnum: [ 6616, 6783 ]
+      value: 10.1998
+
+  K:
+    - runnum: [ 5674, 5870 ]
+      value: 7.546
+    - runnum: [ 5875, 6000 ]
+      value: 6.535
+
+  F:
+    - runnum: [ 12210, 12388 ]
+      value: 10.389
+    - runnum: [ 12389, 12443 ]
+      value:  2.186
+    - runnum: [ 12444, 12951 ]
+      value: 10.389
+
+  M:
+    - runnum: [ 15013, 15490 ]
+      value: 5.98636
+    - runnum: [ 15533, 15727 ]
+      value: 2.07052
+    - runnum: [ 15728, 15784 ]
+      value: 4.02962
+    - runnum: [ 15787, 15884 ]
+      value: 5.98636
+
+  B:
+    - runnum: [ 6120, 6399 ]
+      value: 10.5986
+    - runnum: [ 6409, 6604 ]
+      value: 10.1998
+    - runnum: [ 11093, 11283 ]
+      value: 10.4096
+    - runnum: [ 11284, 11300 ]
+      value: 4.17179
+    - runnum: [ 11323, 11571 ]
+      value: 10.3894