This guide assumes that you're interested in looking at runs which have been processed by the Promt Reconstruction system (PC and ER). The first step of the processing is the Prompt Calibration (PC) pass, the second step of the processing is Event Reconstruction (ER) pass. The ER step is made with more statistics than the PC step. Therefore, the ER pass it is more suitable to test the QA of the runs, but the PC can be usefull to find release or calibration problems as well as.

• The package RqmRootTreeTools is almost release-independent, so any release-18 should be fine (at the moment there is a problem with the Root version in release-22.x.x series, plese use release-18.x.x). If you're using a too old release, you may have trouble in processing the root QA files.

• Checkout the package in your test release. You can get the head version with addpkg -h RqmRootTreeTools but it is not guaranteed to be working fine. It is safer to find the last official tag (VXX-YY-ZZ), either in the Data Quality Hypernews or directly in the CVS repository. The current manager of this package is Ian Bingham .
• Compile it:
  gmake lib
  gmake bin
• Finally, make sure that the executables have been created RqmReader RqmDoCharts RqmMerge RqmTestRootFile RqmChecker ; and also two perl scripts: RqmMakeAll RqmFindBad .

• RqmMakeAll processes a list of runs which can be provided on two different formats which are mutually exclusive (don't mix them in the same input file!).
  1. <run number> <processing>
     example: 55402 P18.1.0cV00fb
  2. Absolute paths pointing to the OPR ROOT files
     example: /nfs/babar/DQG/hbook/ER3/18.0.4c/35698-P18.0.4cV00fb.merged.root.gz
  For weekly QA checks, the RQM (currently Roberto Sacco .) prepares lists of runs in both format and makes them available on the Stripcharts webpage. The RQM sends an e-mail to the Data Quality Hypernews when a new list is available: one has usually 2-3 days to check the runs before the DQG meeting held on Thursday morning @ 10.00.
  The RQM also runs RqmMakeAll on the run lists he's producing ⇒ you'll get automated messages as well. But I find more convenient to rerun the jobs on my own: first, the RQM may not use the latest version of RqmRootTreeTools; second, he/she doesn't use the DIRC specific functionnalities (Run-dependent stripchart ranges, DIRC-customized stripchart plots production etc.) detailled below which make the QA checks easier and... faster!
• The list of runs should be in your workdir. To use the checkRuns.pl perl script (DIRC home-made), the name of the file must obey the following convention: runList-<tag>.txt where <tag> is the label you chose to identify this set of runs (for instance Run5-2005-11-10 for a list of Run 5 runs to be checked before the DQG meeting of November 10^th 2005).
• You also need to edit ER_Default.tcl again. Whereas the changes to this file described above had to be done once in your life of QA checker, the setup below needs to be adapted each time you're going to run a new job.
  • Set the run boundaries <RUNSTART_STRIP>, <RUNSTOP_STRIP>, <RUNSTART_QA> and <RUNSTOP_QA> . These variables define the range of runs included in the QA check such as the extend of the x-axis in all stripchart postscript plots. Be sure to start/stop at least 1 run before/after the first/last run number included in the run file: otherwise, the extreme runs will not be checked (code feature!). I never completely understood the difference between the two START/STOP parameters: the simpler is to set them to equal values.

  The next bullet will only apply for the DIRC code, but it can be implemented for any other subsystem.

  • ER_Default.tcl also allows one to setup parameters which are defined and used in a subsystem monitoring code (for the DIRC these are the files DircTreeMaker.cc/.hh and DircStripChartsCollection.cc/.hh). The DIRC code has three such parameters: <CONFIG:DRC:DRC_run>, <CONFIG:DRC:DRC_minNumErrors> and <CONFIG:DRC:DRC_countErrors>.
    The first one, <CONFIG:DRC:DRC_run>, is used to define the Run (note the capital 'R') during which the runs contained in the input list have been taken. The values of this parameter are currently 0 (default), 1, 2, 3, 4 and 5. As the data taking conditions have significantly evolved since the beginning of BaBar, the boundaries of the 'nominal range' associated with each stripchart have been made Run-dependent to ensure that the QA check parameters follow the evolution of data.
    The second parameter (<CONFIG:DRC:DRC_minNumErrors>) sets the minimum number of failed QA checks needed in a given run to trigger an automatic report for this run. RqmMakeAll adds this report in a text buffer which is sent to the subsystem expert(s) by e-mail when the QA check ends. For new runs which have never been checked before by the DQG group, it is safer to set this parameter to 1. If several tens (hundreds!) of reprocessed runs (i.e. which have been already checked in the past) have to be checked, increasing this parameter to 2 is a convenient way to prevent the log file sent by e-mail from being too big.
    Finally, uncommenting the last parameter (<CONFIG:DRC:DRC_countErrors>) by removing the '#' which starts the line makes the DIRC part of RqmMakeAll more verbose to ease the debugging of the code if needed.
• Finally, copy the perl macro checkRuns.pl in your workdir. This macro was made by Nicolas Arnaud and aims at launching QA jobs more easily.
• Then, you can launch the perl script:
  perl checkRuns.pl <tag> <Run Number> <Format>
  • <tag> is the file ID which you used to label the list of runs on which RqmMakeAll will run.
  • <Run Number> must be equal to the corresponding parameter defined in ER_Default.tcl (<CONFIG:DRC:DRC_run>, see above for details). It is an input of the home-made ROOT macro plotDircStripcharts.cc included in the RqmRootTreeTools package. Called by the perl script after RqmMakeAll, it produces a nice postscript file gathering all the DIRC stripcharts: the time evolution (vs. run number) and the histogram of each monitored quantity are displayed, with red lines showing the current limits of the nominal range.
  • <Format> is equal to 1 or 2 depending on the file format chosen. Its default value is 1 and so setting it is not compulsory if you're using the format <run number> <processing>. In this case, perl checkRuns.pl <tag> <Run Number> should work fine!
• You can also run RqmMakeAll directly without using the perl script. Examples of command are in the README file of the RqmRootTreeTools package. They can also be guessed by looking at the DIRC perl macro code. The output postscript files will also have generic names -- they are renamed in the macro code.

• A logfile called <tag>.rqmlog.
• Two ROOT files ER-new_<tag>.root and ER_<tag>.root which are analyzed in a second step by the ROOT macro plotDircStripcharts.cc.
• A postscript file showing the stripchart evolution 'a la RqmRootTreeTools': ER_<tag>.ps.


• A similar file produced by plotDircStripcharts.cc: DIRC_stripcharts_<tag>.ps. For each stripchart, two plots are displayed: on the left, the histogram of the variable; on the right, its evolution as a function the run number. Red lines show the boundaries of the allowed region for this stripchart.
• Various other files not interesting for QA.

1. to run RqmMakeAll of the list of runs as described above;
2. to check the QA plots of the runs which don't pass the DIRC automatic monitoring;
   [Bad runs are normally clearly visible: they fail most of the automated checks and the corresponding stripcharts often have crazy values (null occupancy etc.)]
3. to look at the DIRC QA stripcharts to have an overview of the run quality and to identify unexpected long-term evolution of some stripcharts -- like for instance a net decrease of the mean number of photons per track.