> For the complete documentation index, see [llms.txt](https://friederikebock.gitbook.io/pcgtutorial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://friederikebock.gitbook.io/pcgtutorial/quality-assurance-and-energy-calibration-of-calorimeters/overview.md). # Overview This chapter is about the very first and highly important step of performing any analysis: the **Quality Assurance (QA)** of recorded data and Monte Carlo (MC) productions. It is important to ensure that all detectors behave as expected and that related observables (a couple of examples: Number of Tracks in TPC, dE/dx of electrons, Number of calorimeter clusters found,...) are described properly by MC simulations. In particular, it is important to check that any of these observables is the same for all the subsets of the data, namely for all different runs that were recorded. If this is not the case, the differences *must* be understood in case the MC does not follow. The QA framework can be found within the [AnalysisSoftware Repository](https://gitlab.cern.ch/alice-pcg/AnalysisSoftware) in *TaskQA/\** , it is split into the major parts: 1. [Event QA](/pcgtutorial/quality-assurance-and-energy-calibration-of-calorimeters/eventqa.md) 2. [Photon QA](/pcgtutorial/quality-assurance-and-energy-calibration-of-calorimeters/photonqa.md) 3. [Cluster QA](/pcgtutorial/quality-assurance-and-energy-calibration-of-calorimeters/clusterqa.md) 4. [PrimaryTrack QA](/pcgtutorial/quality-assurance-and-energy-calibration-of-calorimeters/primaryqa.md) As data taking is split into runs, a so-called runwise QA must be run on the desired data/MC to analyze. Furthermore, it is important to globally check the observables for the full statistics. > The respective macros can be found in *TaskQA/EventQA.C* and *TaskQA/EventQA\_Runwise.C* (and accordingly for the other three examples) Generally, all calorimeter related macros/functions should be able to handle EMCal as well as PHOS and DCal, but for last two calorimeters special care needs to be taken and every QA step still needs to be verified in detail (after sucessful validation this statement may be removed). ## GRID running All QA tasks need to have the *slow* option active as well as *runwise processing* must be enabled on GRID (remember to include this in your request [Requesting a LEGO Train](/pcgtutorial/aliphysics-implementation-and-grid-running/legotrains.md)). * The PhotonQA is run by specialized wagons running the AddTask\_PhotonQA, they can be found on the MonAlisa pages in the *Group PCM* - look for *PhotonQA\**. * The EventQA needs the standard output by one of our standard analysis tasks (GammaConvV1, GammaCalo, GammaConvCalo,..) * For ClusterQA peferably run the standard calorimeter-related tasks GammaCalo & GammaConvCalo (as you will need output from both to verify the energy calibration) - if bad cell identification should be performed in addition, one of both tasks need to be run with QA level, for example '5' to enable full QA output including cell QA Two different sets of download macros are available in *DownloadAndDataPrep/\** and *TaskQA/Grid\_CopyFiles\**, see [Download Files from GRID](/pcgtutorial/aliphysics-implementation-and-grid-running/download.md) to download the runwise output as well as the fully merged output from GRID. ## Processing Always run the runwise macros first, then the merged output (also referred to as periodwise or full output)! For runwise processing with the QA framework, the *Gamma\*.root* files should be placed in the following folder scheme in the AnalysisSoftware folder ([AnalysisSoftware Repository](https://gitlab.cern.ch/alice-pcg/AnalysisSoftware)): > DataQA/DATE/PERIODNAME/RUNNUMBER/Gamma\*.root (for example: DataQA/20180104/LHC15h1b/177681/GammaCalo\_104.root and so on for the differnt runs available for the given dataset) Furthermore, all screen output is saved in *\*.log* files - watch for them if you want to look up any information. Make sure that a file *runlistsPERIODNAME.txt* (for example runlistsLHC15h1b.txt) is contained in *DownloadAndDataPrep/runlists* containing the different run numbers line by line (examples may be found when checking out from [AnalysisSoftware Repository](https://gitlab.cern.ch/alice-pcg/AnalysisSoftware)) as the QA framework will look for the run numbers in that folder per default. **Central Steering Macros** The central steering macros for the QA framework are: * QAV2.C * QA\_RunwiseV2.C which can be called from bash via: > root -x -l -b -q TaskQA/QAV2.C+("config.txt",kTRUE,kTRUE,kTRUE,kTRUE,kTRUE,2,"eps") and > root -x -l -b -q TaskQA/QA\_RunwiseV2.C+("config.txt",kTRUE,kTRUE,kTRUE,kTRUE,kTRUE,2,"eps") Example configurations for *config.txt* may be found within *TaskQA/ExampleConfigurations* while the other parameters of the functions stand for: * doEventQA -> *kTRUE* * doPhotonQA -> *kTRUE* (set *kFALSE* if you are not using any photon conversions) * doClusterQA -> *kTRUE* (set *kFALSE* if you are not using any calorimeter clusters) * doMergedQA -> *kTRUE* (set *kFALSE* if you are not running a merged analysis) * doPrimaryTrackQA -> *kTRUE* (set *kFALSE* if you are not running Dalitz or neutral meson analysis via 3 pions) * doExtQA -> *2* (*0* -> switched off, *1* -> normal QA mode, *2* extendedQA mode with cell QA) * suffix -> *eps* (*pdf*,*C*,...) The config file is the central place to modify your QA. It allows you to specify the used mode, analyzed system, the dataset used and most others settings needed for the different parts of the QA. Please note that you should only **use either spaces or tabs as delimiters, but not a mix of the two**, because this can cause problems during execution of the macro. **IMPORTANT FOR RUNNING PHOTON QA** As we are using TTrees for the photon QA, there is a slightly different approach in this case: ***only*** **download runwise output for the photon QA, as in most cases the full merges** ***will*** **fail on GRID due to huge output size!** > during processing of PhotonQA\_Runwise.C, the periodwise output will be automatically produced! ## Energy Calibration of Calorimeters Furthermore, the energy calibration of calorimeters directly follows the QA stage and is described in * [Energy Calibration of Calorimeters](/pcgtutorial/quality-assurance-and-energy-calibration-of-calorimeters/ecalib.md) > the macros are contained in [AnalysisSoftware Repository](https://gitlab.cern.ch/alice-pcg/AnalysisSoftware) in TaskV1/\* In general, the calibration of calorimeters is performed by the specific detector groups for EMCal/DCal and PHOS. What we are referring to in this chapter is an improved energy calibration scheme based on the measured neutral pion peak position in data to which the simulated MC mass positions are tuned to. In general, it may happen that an improved energy calibration is not needed but still then the macros should be run to cross-check the calibration.