This tutorial is meant as an introduction to the software packages provided by the Photon Conversion Group (PCG). As it is still under development as is the software it does not claim completeness. However, it should provide a good start for new-comers and oldies to get started on a new topic. If you wanna help improving this documentation you are very welcome and just need to let us know and e-mail Friederike. She will grant you access to the documentation git as well.
In the provided software package the reconstruction of photons within ALICE using different detectors (EMCal, DCal, PHOS, TPC & ITS) is handled in a common way and the neutral mesons can be extracted using different techniques. Furthermore the software can be used as analysis level QA for the corresponding detectors focussing on the quantities relevant for the corresponding photon reconstruction.
Our software is structured in 3 main parts hosted on GitHub and GitLab:
  1. 1.
    AliPhysics implementation in PWGGA/GammaConv, which is running on the reconstructed ESD/AOD data or simulation files
  2. 2.
    Afterburner implementation which is kept and maintained in the PCG-Software directory and is used to analyse the output files of the AliPhysics-Tasks to extract the meson spectra (
    π0,η,ω\pi^0, \eta, \omega
    and direct photon results. It is named AnalysisSoftware repository
  3. 3.
    Cocktail implementation, which is scattered in 2 different places in AliPhysics (PWG/Cocktail & PWGGA/GammaConv) and which has to fed by inputs summarized in the Cocktail-Repository
All three packages will be needed to complete the full meson and direct photon analysis as it is currently implemented and will be explained in the following tutorial in different sections.
Furthermore, we have a repository (named AnalysisNotes) hosting all analysis/combination notes PCG-Notes repository where you should contribute with your own analysis note once your analysis reached an advanced stage and is targeted to be included in a publication.
The AliPhysics repository is automatically installed, the rest of the repositores can be cloned to your local disk (remember the SSH key registration!) via the following commands:
To gain committer-access to the PCG-Software directories (AnalysisSoftware and AnalysisNotes) please subscribe to alice-pcg & alice-pcg-core on e-groups and to get the committer access to the Cocktail repository you have to be subscribed to alice-cocktail-EM. For AliPhysics such a subscribtion is not needed as you create your own fork of the repository and do pull-requests as described in Working with AliPhysics.
Last but not least, the last GitHub repository is our GitBook tutorial repository to complete the list (which you are reading) PCG-tutorial which is linked to the GitBook itself Tutorial


If there are any questions regarding this tutorial do not hesitate to ask on
or directly to the convenors and creators of the tutorial
We are happy to help.

Communication Tools

Besides the egroup and email contact, the PCG uses mattermost (ALICE-PWGGA). There are different channels to discuss specific analyses or other topics.
Weekly meetings of the PCG
Weekly meetings of the PCG take place on vidyo PCG @ Indico. They are usually scheduled for Wednesday, 2pm, and open to anybody with interest in the topic. Announcements are sent around via the main egroup
which you should be registered to in addition to [email protected] -> see e-groups

Additional Information

useful links
Last modified 8mo ago