From 6d4c38eab228296f0708acdadf4ccd1118858e1e Mon Sep 17 00:00:00 2001 From: Anisa Khatun Date: Sat, 4 Oct 2025 23:06:43 +0530 Subject: [PATCH 1/2] PWG-UD specific feature documentation Detail descriptions of PWG-UD analysis workflow --- docs/advanced-specifics/pwgud.md | 46 +++++++++++++++++++++++++++++--- 1 file changed, 43 insertions(+), 3 deletions(-) diff --git a/docs/advanced-specifics/pwgud.md b/docs/advanced-specifics/pwgud.md index 66043687..393c1818 100644 --- a/docs/advanced-specifics/pwgud.md +++ b/docs/advanced-specifics/pwgud.md @@ -4,13 +4,53 @@ title: PWG-UD --- # Ultra-peripheral collisions and diffraction (UD) analysis framework +The **PWG-UD** (Ultra-peripheral and Diffractive) working group focuses on the study of photon-induced and diffractive processes in heavy-ion and proton–proton collisions, as well as cosmic rays. ## Get started +In the past, several hands-on sessions and tutorials have been organised within the **PWG-UD** to introduce the analysis framework. +A list of the corresponding Indico events is provided below. + +### Past tutorials and hands-on sessions + +- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1425820/timetable/#b-571496-pwg-ud-ultra-peripher) from O2 Analysis Tutorial 4.0 (16 October 2024)** - Introduction to the O² framework for UD analyses with practical examples. Includes introduction, [Event selection for UPC](https://indico.cern.ch/event/1425820/contributions/6176711/attachments/2948608/5189086/0-ud-firstpart.mp4), + [Data analysis with UD tables](https://indico.cern.ch/event/1425820/contributions/6176712/attachments/2948661/5189090/0-ud-anisa.mp4) and [MC simulation](https://indico.cern.ch/event/1425820/contributions/6176715/attachments/2948620/5189095/0-ud-simone.mp4). + - Example tasks: + - [`UDTutorial_05.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_05.cxx) – Two-pion analysis at midrapidity + - [`UDTutorial_06.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_06.cxx) – Forward muon analysis + - [`UDTutorial_07.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_07.cxx) – Event-by-event tree creation + + +- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1326201/timetable/#b-528201-pwg-ud-ultra-peripher) from O2 Tutorial 3.0 (8 November 2023)** — Overview of UD tables and accesing MC data [Zoom recording part1](https://indico.cern.ch/event/1326201/contributions/5663204/attachments/2748184/4783585/ud1.mp4) , [Zoom recording part2](https://indico.cern.ch/event/1326201/contributions/5663204/attachments/2748184/4783622/ud2.mp4). + +- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1267433/timetable/#b-508750-parallel-hands-on-pwg) from O2 Tutorial 2.0 (27 April 2023)** — Introduction to UD tables, task developement and hands-on sessions, [Zoom recording part1](https://indico.cern.ch/event/1267433/sessions/490459/attachments/2636549/4565155/ud-piece1.mp4), [Zoom recording part2](https://indico.cern.ch/event/1267433/sessions/490459/attachments/2636549/4565156/ud2.mp4) + +- **[O2 Analysis Tutorial (13–14 October 2022)](https://indico.cern.ch/event/1200252/](https://indico.cern.ch/event/1200252/timetable/#20221013.detailed))** — General introduction to the O2 analysis framework. + + ## Contact +Mattermost channels: [PWG-UD O2 analyses](https://mattermost.web.cern.ch/alice/channels/pwg-ud-o2-analyses) , [PWG-UD general](https://mattermost.web.cern.ch/alice/channels/pwg-ud) , [O2AT-PWG-UD](https://mattermost.web.cern.ch/alice/channels/o2at-pwg-ud) ## Code -- The codebase can be found in the -[`PWGUD`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD) directory. -.h). +- The PWG-UD analysis code is located in the directory +[`PWGUD`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD) +- Data model can be found here - [UDTables.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/DataModel/UDTables.h) +- Table produced by skimming and selecting event with double gap topology at midrapidity - [DGCandProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/DGCandProducer.cxx) +- Class for event selection with double gap at midrapidity - [DGSelector.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/DGSelector.h) +- Table produced by skimming and selecting event with single gap topology at midrapidity - [SGCandProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/SGCandProducer.cxx) +- Class for event selection with single topology at midrapidity - [SGSelector.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/SGSelector.h) +- Class for track selection with single gap topology at midrapidity - [SGTrackSelector.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/SGTrackSelector.h) +- Table produced by skimming and selecting event with muon arm at forward rapidity - [UPCCandidateProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/UPCCandidateProducer.cxx). +- Utility and helper functions: [UDHelpers.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/UDHelpers.h) +- Utility and helper functions: [`Tasks/CMakeLists.txt`](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Tasks/CMakeLists.txt) +- Quality assurance (QA) tasks: [`AQC`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD/AQC) + + + ## AliHyperloop + + [UD Hyperloop analyses](https://alimonitor.cern.ch/hyperloop/all-analyses) with [JIRA tickets](https://its.cern.ch/jira/projects/PWGUD/issues/PWGUD-11?filter=allopenissues) + + ## Framework structure + A schematic diagram of the typical workflow for a PWG-UD analysis is shown below. +
PWGUD analysis framework
From 58a62cd830d069788ebb61ead865b1cb974fbeb7 Mon Sep 17 00:00:00 2001 From: Anisa Khatun Date: Sat, 4 Oct 2025 23:29:03 +0530 Subject: [PATCH 2/2] Fixed white space Removed additional white spacing --- docs/advanced-specifics/pwgud.md | 54 +++++++++++++++++--------------- 1 file changed, 29 insertions(+), 25 deletions(-) diff --git a/docs/advanced-specifics/pwgud.md b/docs/advanced-specifics/pwgud.md index 393c1818..bbf70d2c 100644 --- a/docs/advanced-specifics/pwgud.md +++ b/docs/advanced-specifics/pwgud.md @@ -4,53 +4,57 @@ title: PWG-UD --- # Ultra-peripheral collisions and diffraction (UD) analysis framework -The **PWG-UD** (Ultra-peripheral and Diffractive) working group focuses on the study of photon-induced and diffractive processes in heavy-ion and proton–proton collisions, as well as cosmic rays. +The **PWG-UD** (Ultra-peripheral and Diffractive) working group focuses on the study of photon-induced and diffractive processes in heavy-ion and proton–proton collisions, as well as cosmic rays. ## Get started -In the past, several hands-on sessions and tutorials have been organised within the **PWG-UD** to introduce the analysis framework. +In the past, several hands-on sessions and tutorials have been organised within the **PWG-UD** to introduce the analysis framework. A list of the corresponding Indico events is provided below. ### Past tutorials and hands-on sessions -- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1425820/timetable/#b-571496-pwg-ud-ultra-peripher) from O2 Analysis Tutorial 4.0 (16 October 2024)** - Introduction to the O² framework for UD analyses with practical examples. Includes introduction, [Event selection for UPC](https://indico.cern.ch/event/1425820/contributions/6176711/attachments/2948608/5189086/0-ud-firstpart.mp4), + + +- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1425820/timetable/#b-571496-pwg-ud-ultra-peripher) from O2 Analysis Tutorial 4.0 (16 October 2024)** - Introduction to the O² framework for UD analyses with practical examples. Includes introduction, [Event selection for UPC](https://indico.cern.ch/event/1425820/contributions/6176711/attachments/2948608/5189086/0-ud-firstpart.mp4), [Data analysis with UD tables](https://indico.cern.ch/event/1425820/contributions/6176712/attachments/2948661/5189090/0-ud-anisa.mp4) and [MC simulation](https://indico.cern.ch/event/1425820/contributions/6176715/attachments/2948620/5189095/0-ud-simone.mp4). - - Example tasks: - - [`UDTutorial_05.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_05.cxx) – Two-pion analysis at midrapidity - - [`UDTutorial_06.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_06.cxx) – Forward muon analysis + - Example tasks: + - [`UDTutorial_05.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_05.cxx) – Two-pion analysis at midrapidity + - [`UDTutorial_06.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_06.cxx) – Forward muon analysis - [`UDTutorial_07.cxx`](https://github.com/AliceO2Group/O2Physics/blob/master/Tutorials/PWGUD/UDTutorial_07.cxx) – Event-by-event tree creation - -- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1326201/timetable/#b-528201-pwg-ud-ultra-peripher) from O2 Tutorial 3.0 (8 November 2023)** — Overview of UD tables and accesing MC data [Zoom recording part1](https://indico.cern.ch/event/1326201/contributions/5663204/attachments/2748184/4783585/ud1.mp4) , [Zoom recording part2](https://indico.cern.ch/event/1326201/contributions/5663204/attachments/2748184/4783622/ud2.mp4). +- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1326201/timetable/#b-528201-pwg-ud-ultra-peripher) from O2 Tutorial 3.0 (8 November 2023)** — Overview of UD tables and accesing MC data [Zoom recording part1](https://indico.cern.ch/event/1326201/contributions/5663204/attachments/2748184/4783585/ud1.mp4), [Zoom recording part2](https://indico.cern.ch/event/1326201/contributions/5663204/attachments/2748184/4783622/ud2.mp4). -- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1267433/timetable/#b-508750-parallel-hands-on-pwg) from O2 Tutorial 2.0 (27 April 2023)** — Introduction to UD tables, task developement and hands-on sessions, [Zoom recording part1](https://indico.cern.ch/event/1267433/sessions/490459/attachments/2636549/4565155/ud-piece1.mp4), [Zoom recording part2](https://indico.cern.ch/event/1267433/sessions/490459/attachments/2636549/4565156/ud2.mp4) +- **[UD/O2 hands-on sessions](https://indico.cern.ch/event/1267433/timetable/#b-508750-parallel-hands-on-pwg) from O2 Tutorial 2.0 (27 April 2023)** — Introduction to UD tables, task developement and hands-on sessions, [Zoom recording part1](https://indico.cern.ch/event/1267433/sessions/490459/attachments/2636549/4565155/ud-piece1.mp4), [Zoom recording part2](https://indico.cern.ch/event/1267433/sessions/490459/attachments/2636549/4565156/ud2.mp4). -- **[O2 Analysis Tutorial (13–14 October 2022)](https://indico.cern.ch/event/1200252/](https://indico.cern.ch/event/1200252/timetable/#20221013.detailed))** — General introduction to the O2 analysis framework. +- **[O2 Analysis Tutorial (13–14 October 2022)](https://indico.cern.ch/event/1200252/timetable/#20221013.detailed)** — General introduction to the O2 analysis framework. + ## Contact -Mattermost channels: [PWG-UD O2 analyses](https://mattermost.web.cern.ch/alice/channels/pwg-ud-o2-analyses) , [PWG-UD general](https://mattermost.web.cern.ch/alice/channels/pwg-ud) , [O2AT-PWG-UD](https://mattermost.web.cern.ch/alice/channels/o2at-pwg-ud) + +Mattermost channels: [PWG-UD O2 analyses](https://mattermost.web.cern.ch/alice/channels/pwg-ud-o2-analyses), [PWG-UD general](https://mattermost.web.cern.ch/alice/channels/pwg-ud), [O2AT-PWG-UD](https://mattermost.web.cern.ch/alice/channels/o2at-pwg-ud) + ## Code - The PWG-UD analysis code is located in the directory -[`PWGUD`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD) +[`PWGUD`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD) - Data model can be found here - [UDTables.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/DataModel/UDTables.h) - Table produced by skimming and selecting event with double gap topology at midrapidity - [DGCandProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/DGCandProducer.cxx) - Class for event selection with double gap at midrapidity - [DGSelector.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/DGSelector.h) - Table produced by skimming and selecting event with single gap topology at midrapidity - [SGCandProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/SGCandProducer.cxx) - Class for event selection with single topology at midrapidity - [SGSelector.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/SGSelector.h) - Class for track selection with single gap topology at midrapidity - [SGTrackSelector.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/SGTrackSelector.h) -- Table produced by skimming and selecting event with muon arm at forward rapidity - [UPCCandidateProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/UPCCandidateProducer.cxx). -- Utility and helper functions: [UDHelpers.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/UDHelpers.h) -- Utility and helper functions: [`Tasks/CMakeLists.txt`](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Tasks/CMakeLists.txt) -- Quality assurance (QA) tasks: [`AQC`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD/AQC) - - - ## AliHyperloop - - [UD Hyperloop analyses](https://alimonitor.cern.ch/hyperloop/all-analyses) with [JIRA tickets](https://its.cern.ch/jira/projects/PWGUD/issues/PWGUD-11?filter=allopenissues) - - ## Framework structure - A schematic diagram of the typical workflow for a PWG-UD analysis is shown below. -
PWGUD analysis framework
+- Table produced by skimming and selecting event with muon arm at forward rapidity - [UPCCandidateProducer.cxx](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/TableProducer/UPCCandidateProducer.cxx) +- Utility and helper functions: [UDHelpers.h](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Core/UDHelpers.h) +- Utility and helper functions: [`Tasks/CMakeLists.txt`](https://github.com/AliceO2Group/O2Physics/blob/master/PWGUD/Tasks/CMakeLists.txt) +- Quality assurance (QA) tasks: [`AQC`](https://github.com/AliceO2Group/O2Physics/tree/master/PWGUD/AQC) + +## AliHyperloop + +[UD Hyperloop analyses](https://alimonitor.cern.ch/hyperloop/all-analyses) with [JIRA tickets](https://its.cern.ch/jira/projects/PWGUD/issues/PWGUD-11?filter=allopenissues) + + +## Framework structure +A schematic diagram of the typical workflow for a PWG-UD analysis is shown below. +
PWGUD analysis framework