From 673bd92d494d85c6851d732e442a876d293bdeb4 Mon Sep 17 00:00:00 2001
From: hallc-online <hallc-online@jlab.org>
Date: Mon, 27 Mar 2017 18:06:36 -0400
Subject: [PATCH] Add a short description of how to calibrate SHMS calorimeter.

---
 CALIBRATION/shms_cal_calib/howto.txt | 31 ++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 CALIBRATION/shms_cal_calib/howto.txt

diff --git a/CALIBRATION/shms_cal_calib/howto.txt b/CALIBRATION/shms_cal_calib/howto.txt
new file mode 100644
index 00000000..1335b2ba
--- /dev/null
+++ b/CALIBRATION/shms_cal_calib/howto.txt
@@ -0,0 +1,31 @@
+How to calibrate SHMS calorimeter with real electrons.
+
+The calibration scripts reside in
+hallc_replay/CALIBRATION/shms_cal_calib directory. They consist of 3
+header files called THcPShHit.h,THcPShTrack.h, THcPShowerCalib.h, and
+a steering script pcal_calib.cpp.
+
+The scripts work on root files from hcana analysis and make use of
+quantities pertained to tracking, heavy gas Cherenkov, and TOF from
+hodoscopes. Hence it is convenient to calibrate on root files from
+full SHMS analysis. The root files are assumed in a linked ROOTfiles
+directory, under names shms_replay_<run_number>.root.
+
+Once your hcana, hallc_replay and Root are set up, you can compile and
+run pcal_calib under hcana, by issuing command
+
+.x pcal_calib.cpp+("run number").
+
+For instance, for calibration on shms_replay_464_50000.root file in
+ROOTfiles, the correct commad would be
+
+.x pcal_calib.cpp+("464_50000") .
+
+Upon calibration, a canvas with representative plots will pop up. The
+calibration constants will be written in output file
+pcal.param.<run_number>, in a format suitable for plugging them into
+your pcal.param file for subsequent use.
+
+If you want to modify selection cuts used in calibration (cuts on
+delta, beta, gas Cherenkov signals), you can find them at the
+beginning of THcPShowerCalib.h file, in the #define directives.
-- 
GitLab