Welcome to the ATLAS Analysis Software Tutorial pages.

This is the portal to the ATLAS analysis software tutorial held multiple times throughout the year.

This tutorial is aimed at (new and old) members of the ATLAS collaboration interested in learning the basics of ATLAS software and the latest physics analysis tools. There are several introductory lectures aimed at introducing the topics.


Tutorial Week

Follow a week-long analysis software tutorial with lectures and hands-on exercises. The new tutorial format (as of November 2022) is designed to be done in small groups and to follow an example ATLAS analysis from beginning to end. The introductory material and hands-on exercises are kept available online, so if you cannot attend a tutorial week, you can still work through the material.

The curriculum, recorded lectures (for self-guided/asynchronous study), and links to the exercises are available at:

Tutorial material


Prerequisites

Exercises

This week of tutorials requires that participants be familiar with some computing basics. We will be working in a linux terminal and writing code in C++ and python. It is important that you have some working knowledge of these tools before you attend the software tutorial

Please work through the Unix shell, C++, Python and ROOT sections in Fundamentals.

Additionally, please work through the Software Essentials Git sections. Please work from “Git For Analysis” through “SSH Keys”, noting that “Add a Submodule” is optional.

Software

Please make sure that you have X11 installed on your computer. This is necessary for opening windows from a remote machine. If you do not already have it installed, please do so following the appropriate link for your OS:

tip If you are using Windows, it may be simpler to use Windows Subsystem for Linux (WSL) to get access to a linux kernel natively on your computer. Follow these instructions to set up WSL and X11 on Windows 10 and Windows 11.

To test whether you already have X11 installed, use the xterm command from your terminal. If a new terminal-like window opens, X11 is installed. Alternatively you can often use the xeyes command to open an interactive set of eyes, though this may not always be available.


Tutorial Events (past and present)

Upcoming/Latest Tutorial
Online Dec 2024: 2 - 6 Dec 2024
CERN Nov 2024: 19 - 22 Nov 2024
Induction Day + Account Setup: 18 Nov 2024
Previous Tutorials
Online June 2024: 24 - 28 June 2024
CERN June 2024: 11 - 14 June 2024
Induction Day + Account Setup: 10 June 2024
Online March 2024: 25 - 29 March 2024
CERN March 2024: 12 - 15 March 2024
Induction Day + Account Setup: 11 March 2024
Online November 2023: 13 - 17 November 2023
CERN October 2023: 31 October - 3 November 2023
Induction Day + Account Setup: 30 October 2023
Online July 2023: 31 July - 4 August 2023
CERN July 2023: 18 - 21 July 2023
Induction Day + Account Setup: 17 July 2023
Online March 2023: 27 - 31 March 2023
CERN March 2023: 14 - 17 March 2023
CERN November 2022: 15 - 18 November 2022
Hybrid ATLAS Induction Day + Software Tutorial: 27 June - 1 July 2022
Online ATLAS Induction Day + Software Tutorial: 21 - 25 March 2022
Online ATLAS Induction Day + Software Tutorial: 29 Oct - 5 Nov 2021
Online ATLAS Induction Day + Software Tutorial: 16 - 23 July 2021
Online ATLAS Induction Day + Software Tutorial: 19 - 26 Feb 2021
Online ATLAS Induction Day + Software Tutorial: 6 - 13 Nov 2020
Online ATLAS Induction Day + Software Tutorial: 10 - 17 July 2020
CERN January 2020: 20-24 January 2020
CERN October 2019: 21-25 October 2019
CERN June 2019: 3-7 June 2019


Useful Links

Most of the information for the tutorial can be found under the Analysis SW Tutorial menu at the top of this page. Here are some additional links that you may find helpful:


Additional Tutorials and Resources

There are many more resources outside the scope of this tutorial that may be useful to you. Some of these are ATLAS-specific, and some are more general-purpose. We have compiled some resources here that you may find useful as you continue to learn.

ATLAS

The ATLAS Computing and Software TWiki [Internal] is the go-to resource for all things related to computing in ATLAS.

The ATLAS C++ coding guidelines is crucial in making sure that our code remains easily readable (and therefore extendable) by the collaboration. The guidelines should be followed if you are developing C++ for use in Athena.

The following are some useful ATLAS-specific tutorials.

General HEP resources

The HEP Software Foundation and IRIS-HEP have several trainings available. Topics include: C++, CMake, CI/CD, Docker, version control, python, machine learning, uproot, and many more.

Take a look at the HSF Curriculum page for links to these trainings.

The PyHEP working group (from HSF) brings together a community of developers and users of Python in Particle Physics, with the aim of improving the sharing of knowledge and expertise. A collection of community-driven and community-oriented Python libraries providing HEP at large with an ecosystem for data analysis in Python can be found within the Scikit-HEP project.