Introduction to FCCAnalyses

Juraj Smieško (CERN)

Tutorial

29 September 2026

What is FCCAnalyses

Common analysis framework of the FCC Physics groups
Python on top of ROOT RDataFrame, reads EDM4hep
Comes with Key4hep
Stages: run → final → plots
Getting help: FCC Software Forum, Mattermost

Graph of the Higgs recoil analysis

Example Higgs recoil analysis

How to write an analysis

samples — what to run over
analyzers() — builds the RDataFrame graph
output() — columns to save
Own C++ helpers via include_paths

How are the input files discovered

Campaign + sample name
- looked up in /cvmfs/fcc.cern.ch/FCCDicts
Per sample — input-dir, input-files
Command line — -i / -f
Being unified — FCCAnalyses#557

How to run an analysis

Locally

fccanalysis run ana.py
--test — single test file

HTCondor

fccanalysis submit ana.py
One job per chunk

DIRAC coming soon

FCCAnalyses#538 (B. Wach)
fccanalysis submit grid ana.py
Inputs from EOS or DIRAC LFNs

Questions / Thoughts / Comments?

github.com/HEP-FCC/FCCAnalyses


git clone https://github.com/HEP-FCC/FCCAnalyses.git