2. Generators, Fast Simulation and Analysis

If you want to get started with generation and analysis of fast-simulated events, you’re at the right place.

Fast simulation is currently supported through the Delphes approach. Support for the Papas approach, initially used for FCC-ee, is discontinued.

An analysis ntuple will be produced with ROOT’s RDataFrame, a simple modular event processing framework for high energy physics.

If you have any problems or questions, you can open an issue on the GitHub repository where these lessons are developed.

Contents:

• 2.1. FCC: Getting started with event generation
  • 2.1.1. Overview
  • 2.1.2. Enabling FCCSW
  • 2.1.3. Generators
    • 2.1.3.1. Overview
    • 2.1.3.2. Pythia8
    • 2.1.3.3. Whizard
    • 2.1.3.4. MadGraph5
    • 2.1.3.5. Herwig
    • 2.1.3.6. KKMCee
    • 2.1.3.7. BHLUMI
    • 2.1.3.8. BabaYaga
  • 2.1.4. Hands-on case study: ditau events with KKMCee, Pythia8 and Whizard
    • 2.1.4.1. Generating ditaus with KKMCee
      • 2.1.4.1.1. Generating HepMC events
      • 2.1.4.1.2. HepMC to EDM4hep conversion
        • 2.1.4.1.2.1. Dissection of hepmc2edm.py
        • 2.1.4.1.2.2. Running hepmc2edm.py
    • 2.1.4.2. Generating ditaus with Pythia8
    • 2.1.4.3. Generating ditaus with Whizard
      • 2.1.4.3.1. LHEf to EDM4hep conversion
    • 2.1.4.4. Looking at the produced files: the MCParticle class
      • 2.1.4.4.1. Creating flat ntuples with FCCAnalyses
      • 2.1.4.4.2. Comparing distributions
• 2.2. FCC: Getting started with simulating events in Delphes
  • 2.2.1. Part I: Generate and simulate Events with DelphesEDM4Hep
• 2.3. FCC: Getting started with analysing simulated events
  • 2.3.1. Part II: Analyse with FCCAnalyses
• 2.4. FCC: tracking and vertexing example using specific flavour decays
  • 2.4.1. Installation of FCCAnalyses
  • 2.4.2. Building a custom sub-package in FCCAnalyses
  • 2.4.3. Reconstruction of the primary vertex and of primary tracks
    • 2.4.3.1. Exercises:
  • 2.4.4. Reconstruction of displaced vertices in an exclusive decay chain: starting example
  • 2.4.5. Exercise: analysis of \(\tau \rightarrow 3 \mu\)
• 2.5. FCCAnalyses: Common problems and solutions
  • 2.5.1. Prerequisites
    • 2.5.1.1. EDM4HEP event model
    • 2.5.1.2. Structure of EDM4HEP files
  • 2.5.2. Overall organisation of analysis code (C++)
  • 2.5.3. Reading objects from EDM4HEP
  • 2.5.4. Association between RecoParticles and MonteCarloParticles
  • 2.5.5. Navigation through the history of the MonteCarloParticles
  • 2.5.6. Writing a new function
    • 2.5.6.1. Inline
    • 2.5.6.2. Using ROOT gInterpreter
    • 2.5.6.3. Inside an existing FCCAnalyses namespace
  • 2.5.7. Writing a new struct
  • 2.5.8. Writing a new namespace
  • 2.5.9. Writing your own analysis using the case-studies generator
    • 2.5.9.1. Analysis package generation
    • 2.5.9.2. Analysis package exposure to RDF
• 2.6. Central production of events
  • 2.6.1. Clone and initialisation
  • 2.6.2. Generate LHE files from gripacks
  • 2.6.3. Generate LHE files directly from MG5
  • 2.6.4. Generate STDHEP files directly from Whizard + Pythia6
  • 2.6.5. Generate EDM4hep files from the LHE and decay with Pythia8
  • 2.6.6. Generate EDM4hep files from STDHEP
  • 2.6.7. Generate EDM4hep files from Pythia8
  • 2.6.8. Expert mode
    • 2.6.8.1. Updating the database
    • 2.6.8.2. Cleaning bad jobs
    • 2.6.8.3. Update the webpage
    • 2.6.8.4. Create the sample list for analyses
    • 2.6.8.5. All in One
  • 2.6.9. Produce samples with EventProducer outside of official campaign