The FCC Tutorials

These are the lessons taught during the FCC Software Tutorials (the format is heavily inspired by the LHCb starterkit).

List of previous workshop/tutorial events:

• Computing and software tutorials as part of Second Annual U.S. Future Circular Collider (FCC) Workshop 2024 at MIT; 25–27 Mar 2024.

• Software tutorials as part of First Annual U.S. Future Circular Collider (FCC) Workshop 2023 (Indico) at Brookhaven National Laboratory; 24–26 April 2023.

• FCC Software Hands-on Tutorial at CERN; 19–21 October 2022.

• Software tutorial in the context of the Snowmass 2021 studies; 22, 23 and 29 September 2020.

• Software tutorial as part of the FCC Physics week; 15 January 2020.

• Software Workshop and hands-on tutorial on 2-3 October 2019; an introduction to many topics.

The next tutorial, will be anounced in FCC-PED-SoftwareAndComputing-Documentation e-group, make sure you are subscribed in order to know how to sign up.

If you’d just like to learn about how to use the FCC Software, read on!

Contents:

• 1. First Steps
  • 1.1. Pre-tutorial checklist
  • 1.2. Running the software in SWAN notebooks
  • 1.3. Goals of the course
  • 1.4. An introduction to FCC Software
  • 1.5. Finding data in the Bookkeeping
  • 1.6. Inspecting an FCC data file
  • 1.7. Tips and tricks
  • 1.8. Asking good questions
• 2. Generators, Fast Simulation and Analysis
  • 2.1. FCC: Getting started with event generation
  • 2.2. FCC: Getting started with simulating events in Delphes
  • 2.3. Understanding generated process: eedE
  • 2.4. FCC: Analysing simulated events
  • 2.5. Tracking and vertexing example using specific flavour decays
  • 2.6. FCCAnalyses: Common problems and solutions
  • 2.7. Central production of events
• 3. Full Simulation
  • 3.1. FCC-ee Full Sim General Overview
  • 3.2. Using Guinea-Pig to generate interaction region backgrounds
  • 3.3. Changing geometry
  • 3.4. Visualization
• 4. Distributed computing
  • 4.1. Getting started with FCC distributed computing
  • 4.2. FCC DIRAC example workflows
  • 4.3. Structure for /eos/experiment/fcc/prod
• 5. Developing FCCSW
  • 5.1. Github workflow and contribution guide
  • 5.2. CMake guide for the FCC software
  • 5.3. Writing Gaudi Algorithms
  • 5.4. Developing DD4hep Detector models
  • 5.5. Guide to the Transition of FCCSW to EDM4hep
  • 5.6. Writing documentation for the FCC Software
• 6. Contributing
  • 6.1. Getting Started
  • 6.2. Building the tutorials
  • 6.3. How to Write
  • 6.4. Legal

External links:

• FCC Software
• FCC-ee Detector Full Sim
• FCCAnalyses
• Analysis essentials
• FCC Software glossary