cms-gem-detqc-project / CMS_GEM_Analysis_Framework

Analysis framework for the CMS GEM collaboration
GNU General Public License v3.0
0 stars 4 forks source link

Documentation Needed: Computing HV Setpoints #11

Open bdorney opened 7 years ago

bdorney commented 7 years ago

Brief summary of issue

Need to add a subsection to the README.md for computing HV Setpoints using python/HVSetPointCalculator.py.

The subsection should probably go after Section 3.c.i or Section 3.c.ii

Types of issue

Procedure

  1. First run python/computeGainMap.py for an input detector following instructions here for each detector of interest,
  2. Then fit the average, min, and max gain curves produced by computeGainMap.py with a TF1 where the TFormula used is: exp([0]*x+[1]) for each detector of interest.
  3. Prepare a tab delimited text file where the first line is column headers and then subsequent lines are: PFN of output file from step 2, Det_SN for this file, and Detector_Name field (e.g. what you gave to the run config file),
  4. Determine HV setpoint for a given average gain for each detector using python/HVSetPointCalculator.py

For step 2 above you can used the genericPlotter executable and this example config file: configQC5_Eff_Gain_Short1_Imon_Comp.txt

Input file structure for step 3 above.

Filename    Det_SN  Detector_Name
/path/to/genericPlotter/Output/file1.root    Det_SN1    Detector_Name
/path/to/genericPlotter/Output/file2.root    Det_SN2    Detector_Name
/path/to/genericPlotter/Output/file3.root    Det_SN3   Detector_Name

Example syntax for Step 4:

python2.7 python/HVSetPointCalculator.py --gain=1e4 --fileGainMapList=HVSettings.txt

Please note that python/HVSetPointCalculator.py expects the exact TName format for the min, average, and max gain TF1 objects shown in configQC5_Eff_Gain_Short1_Imon_Comp.txt