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

Material and recorded lectures for the previous tutorial format are available at:

Previous tutorial material



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.


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 November 2023 - 13 - 17 November 2023
CERN October 2023 - 31 October - 3 November 2023
Induction Day + Account Setup - 30 October 2023
Previous Tutorials
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.


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

The ATLAS C++ coding standard is crucial in making sure that our code remains easily readable (and therefore extendable) by the collaboration.

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

Other useful tools used in the HEP community are: