CMS-RPC HVSCAN TOOL USER INSTRUCTIONS

In this twiki you will find instructions to use the HVScan Tool modules.

There are several modules that you can run in a sequence to obtain the following results:

  1. Fit of the curve given by Efficiency vs High Voltage of Operation (Sigmoid function is used).
  2. Fit of the curve given by Cluster Size vs High Voltage of Operation (Exponential function is used).
  3. Plots of the fits mentioned above. In these plots are showed the working point, the knee (both of these according with the definition given by the CMS-RPC group), and the points from where the fit is obtained. It is also possible to plot the working point per channel but this information is not the result of any of these modules.
  4. Classification of the rolls according with the criteria defined by the CMS-RPC group.
  5. ROOT file with the histograms of several distributions.
  6. Web Page with the plots and relevant information about the fit.

The set of modules composing the HVScan Tool are:

  • Translator.C
  • Filter.sh
  • Data.C
  • wpChannel.C
  • Fit.C
  • genPngEffWithWPperChannel.C
  • genPngClsExp.C
  • Classification.C
  • Distributions.C
  • genDataHtml.C
  • genhtml.sh
  • indexhead.html*
  • indexline.html*
  • indexLocal.html*
  • indextail.html*
*Actually, these are not modules but code used by modules.

There is another module that do not belong to the main set but can be useful in some cases, this is:

  • Comparition.C

Explanation for each module:

1. Translator.C
This module is a filter that is applied over the input files; initially, these have more information that the one is needed for doing the HVScan, therefore, this module is used to construct new input files that only have the information required. The original input file has 15 columns and the resulting input file has only the first 5 columns, which information is: roll name, efficiency, efficiency error, number of interpolations and cluster size.
2. Filter.sh
This is a script to select only the lines of a file such as the first element of these files belong to a list that is given as a column in another file. This script is very useful to run the different modules over selected rolls only.
3. Data.C
This module organizes the information of the input files in several folders, one for each roll, allowing in this way to access the information in a easier way.
4. wpChannel.C
This module operates in a similar way that the last one, only that the information is the working point per channel.
5. Fit.C
This module makes the fit for the efficiency and the fit for the cluster size, and creates a file for each roll with the information obtained, which is: working point, slope of the curve at the 50% of the maximum efficiency, maximum efficiency, high voltage at which the efficiency is the 50% of the maximum obtained (HV50), chi square, cluster size at working point, efficiency at working point, working point per channel, efficiency at working point per channel, cluster size at working point per channel and finally, error in the parameter HV50.
6. genPngEffWithWPperChannel.C
This module generates for each roll, the plot of the efficiency fit and show in the same graph the points used to do the fit, as well as, the knee and the working point obtained for the roll and working point obtained for the channel (this last one is obtained using another tool that does not belong to this tool).
7. genPngClsExp.C
This module operates in the very same way that the last one except that instead of plotting the efficiency fit, it plots the cluster size fit.
8. Classification.C
This module makes a selection of the rolls that accomplish the criteria defined by the CMS-RPC group which are:
  • At least one of the runs has to have a bigger high voltage that the one of the knee.
  • The slope of the curve at the 50% of the maximum efficiency must be more than 15.
  • The chi square (normalized) must be less than 30.
  • The maximum efficiency must be more than 30%.
9. Distributions.C
This module generates a ROOT file with the following distributions:
  • Working point.
  • Slope of the curve at the 50% of the maximum efficiency.
  • Maximum efficiency.
  • HV50.
  • Chi square.
  • Cluster size at working point.
  • Efficiency at working point.
  • Working point per channel.
  • Efficiency at working point per channel.
  • Cluster size at working point per channel.
  • Difference between working point and working per channel.
  • Error in parameter HV50.
10. genDataHtml.C
This module creates a file that is the result of merging the different data obtained from Fit module.
11. genhtml.sh
Finally, this module creates a web page where there are shown the plots of the fits and the relevant information related with these (the one obtained in the last module).

Prerequisites for each module:

To use this tool you must have all the modules in the same folder and inside this another folder called data where there must be the input files with name format given by rollYeff(number).txt (where (number) makes reference to the number of the point), additionally, in this last folder there must be a file called luigi.txt with the following information and format:

(number) HV for Barrel Hv for Endcap
with as many lines as points (run information) may be.

Once you have this structure you can run the following modules having in mind the prerequisites for each one of these, which are:

  1. Translator.C: only the structure.
  2. Filter.sh: It is not necessary but can be useful if you only want to run the modules over selected rolls.
  3. Data.C: Translator.C
  4. wpChannel.C: only the structure.
  5. Fit.C: Data.C and if you want to plot the working point per channel, wpChannel.C
  6. genPngEffWithWPperChannel.C: Fit.C
  7. genPngClsExp.C: Fit.C
  8. Classification.C: Fit.C
  9. Distributions.C: Fit.C
  10. genDataHtml.C: Fit.C
  11. genhtml.sh: genDataHtml.C, genPngEffWithWPperChannel.C and genPngClsExp.C

Other modules: Additionally to the the modules explained above, there is another modules which are:

  • Comparition.C: It is used to make the distributions of the parameters difference between two different fits. See note below.

Where to find the results: All the results are stored in a folder called results, that is located inside the main folder of the tool.

Note: It is necessary to change the name of one of the folders (by hand) to the name results11. It must be done before running the tool again with another data, otherwise, all the information will be overwritten.

-- JuanPabloGomez - 13-Jun-2011

Edit | Attach | Watch | Print version | History: r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r1 - 2011-06-13 - JuanPabloGomez
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Sandbox All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback