From 861a7902d4672e46931dff5436d31fd033ffb9fb Mon Sep 17 00:00:00 2001
From: Philip Thomas Templeman <philip.thomas.templeman@cern.ch>
Date: Wed, 27 Mar 2024 17:30:43 +0100
Subject: [PATCH] Add a section documenting how to do an S-curve Analysis to
 run.md

---
 docs/me0/run.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/docs/me0/run.md b/docs/me0/run.md
index 287e4b8..cd11356 100644
--- a/docs/me0/run.md
+++ b/docs/me0/run.md
@@ -87,4 +87,36 @@ Apart from the lines automatically added at the end of the run, you might need t
 - if the data taking went wrong, type "no" in the "GOOD run?" field, otherwise type yes;
 - unless you copied the run data to the shared `eos` folder, type "no" in the "DATA in EOS?" field;
 - paste a link to your elog in the "elog" field;
-- if you have run results, e.g. plots, paste a link to them in the "Results" field.
\ No newline at end of file
+- if you have run results, e.g. plots, paste a link to them in the "Results" field.
+
+# Specific Scans
+
+## S-Curve Scan and Trimming
+
+1. In the xDAQ interface (http://pcuclacvp13:20500/), go to "gem calibration Calibration" and select S-Curve Scan.
+2. If you're doing trimming, set trimming source to "Same for all VFAT". You will take 5 total scans over the trimming values {-63,-31,0,31,63}. If not doing trimming, set trimming source to "From Config DB"
+3. Apply settings in xDAQ and reconfigure. Start the local readout as outlined in the "Data taking" section. Then, hit "Run" in the xDAQ S-curves webpage.
+4. In the terminal with the local readout, you should see Rx begin incrementing after the run is started. When this number stops incrementing (should take 4ish minutes), the run is done.
+5. Once the run is done, stop the local readout with ctrl+C.
+6. Change to another window and cd to `/home/gempro/me0-stack-ng/cmsgemos` for analysis.
+7. Combine the output files (where ${ID} is the 3-digit run id printed after you stop the local readout):
+```bash
+cat /mnt/data/integration/me0stack/online/00000${ID}/*.zst > /mnt/data/integration/me0stack/compressed/00000${ID}-be:fe:00:00:05:c7.raw.zst
+```
+8. Read the raw data (where ${RUN} is the name for your plots directory; format is yyyymmdd_hhmm_shortdescription):
+```bash
+_build/_install/bin/gem-raw-to-histogram /tmp/scurve_${RUN} /mnt/data/integration/me0stack/compressed/00000${ID}-be:fe:00:00:05:c7.raw.zst -a scurve -t amc
+```
+9. Analyze the data:
+```bash
+gemos analyze scurves /tmp/scurve_${RUN} data/scurve_${RUN} -m /home/gempro/me0_stack/cmsgemos-analysis/vfat_me0stack.txt -c  /home/gempro/all_vfats.csv  -u fC -p full
+```
+10. View the plots located in `/home/gempro/me0-stack-ng/cmsgemos/data/scurve_${RUN}/plots`
+11. If doing trimming: for each of the 5 runs, copy `/home/gempro/me0-stack-ng/cmsgemos/data/scurve_${RUN}/scurve-results.root` into the same directory renamed as {trim_n63.root,trim_n31.root,trim_0.root,trim_31.root,trim_63.root}.
+12. Use the script [COMING SOON!] to calculate trimming and generate config values.
+13. Use the script [ALSO COMING SOON!] to generate a new configuration including this trimming.
+14. Load the new config onto the backend:
+``` bash
+scp /home/gempro/me0-stack-ng/config/history/vfat/${NEW_CONFIG}/fed1478-slot2/config-oh* gempro@ctp7-me0:/mnt/persistent/gempro/etc/cmsgemos/vfat/
+```
+
-- 
GitLab