The FAST-HEP workshop contains the runnable tutorials, examples, and training material for FAST-HEP.
The tutorials are organised as a progressive analysis journey: starting with reading data and building simple quantities, then moving through analysis products, reusable workflows, distributed execution, accelerators, and custom extensions.
Each tutorial combines:
The workshop uses reproducible Pixi environments, so examples can be run without assembling the FAST-HEP packages individually.
Begin with a small end-to-end analysis to see how the pieces fit together before exploring them individually.
The first workflow introduces the basic pattern:
flowchart LR
Source["<b>Source</b><br/>read data"]:::source
Transform["<b>Transform</b><br/>compute quantities"]:::transform
Hist["<b>Transform</b><br/>aggregate"]:::transform
Sink["<b>Sink</b><br/>render result"]:::sink
Source --> Transform --> Hist --> Sink
classDef input fill:#f7f7f7,stroke:#5f6368,stroke-width:2px,color:#111111;
classDef flow fill:#e8f0fe,stroke:#3c6fbd,stroke-width:2px,color:#111111;
classDef source fill:#e7f5ff,stroke:#1c7ed6,stroke-width:2px,color:#111111;
classDef transform fill:#fff9db,stroke:#f08c00,stroke-width:2px,color:#111111;
classDef sink fill:#ebfbee,stroke:#2f9e44,stroke-width:2px,color:#111111;
classDef artifact fill:#eadcf8,stroke:#7950a3,stroke-width:2px,color:#111111;
classDef runtime fill:#fce8d5,stroke:#b56b22,stroke-width:2px,color:#111111;
classDef capability fill:#f7f7f7,stroke:#5f6368,stroke-width:2px,color:#111111;
It also introduces the logical graph, execution plan, and artifacts that Flow produces alongside the scientific result.
Start with the workshop overview →
Learn how FAST-HEP introduces data into a workflow.
Topics include:
This section establishes the data sources and event streams used by the rest of the analysis.
Build the scientific content of the analysis.
Topics include:
These tutorials show how operations enrich and transform event streams while Flow derives the required data dependencies during compilation.
Turn processed event data into analysis products.
Topics include:
The tutorials also expose selected generated artifacts, making it possible to see how the declarative description maps onto the outputs produced by FAST-HEP.
Learn how workflows can produce reusable datasets as well as final plots and summaries.
Topics include:
This is particularly useful for workflows where one processing stage produces reduced data for later analysis.
Once the basic operations are familiar, the workshop introduces features needed by larger analyses:
These sections focus on keeping increasingly complex analyses understandable and composable.
The later tutorials explore how the same workflow model can be used with different execution capabilities.
Planned and developing topics include:
These parts of the workshop are evolving alongside the corresponding FAST-HEP implementations.
FAST-HEP is designed around replaceable capabilities.
The extension tutorials show how projects and analyses can provide their own:
using the same interfaces as the standard FAST-HEP packages.
This is the recommended route for experiment-specific and analysis-specific functionality.
These examples show how the individual concepts combine into a realistic, composable FAST-HEP workflow.
flowchart TD
Data["<b>Datasets</b>"]:::source
Operations["<b>Analysis operations</b><br/>selections + systematics"]:::transform
Products["<b>Scientific products</b><br/>histograms + datasets"]:::transform
Rendering["<b>Rendering</b><br/>plots + reports"]:::sink
Provenance["<b>Provenance</b><br/>software + execution record"]:::observer
Data --> Operations --> Products --> Rendering
Operations -.-> Provenance
Products -.-> Provenance
classDef input fill:#f7f7f7,stroke:#5f6368,stroke-width:2px,color:#111111;
classDef flow fill:#e8f0fe,stroke:#3c6fbd,stroke-width:2px,color:#111111;
classDef source fill:#e7f5ff,stroke:#1c7ed6,stroke-width:2px,color:#111111;
classDef transform fill:#fff9db,stroke:#f08c00,stroke-width:2px,color:#111111;
classDef sink fill:#ebfbee,stroke:#2f9e44,stroke-width:2px,color:#111111;
classDef artifact fill:#eadcf8,stroke:#7950a3,stroke-width:2px,color:#111111;
classDef runtime fill:#fce8d5,stroke:#b56b22,stroke-width:2px,color:#111111;
classDef capability fill:#f7f7f7,stroke:#5f6368,stroke-width:2px,color:#111111;
In addition to the guided tutorials, the workshop contains standalone examples that are useful as references when developing your own analyses.
The CMS Open Data dimuon analysis used in Getting started is one such example.
The workshop repository is the canonical source for these workflows so that examples do not need to be duplicated across the documentation.
The workshop is the best place to learn FAST-HEP by doing; these project-level docs explain the architecture and concepts behind those examples.
Workshop documentation · GitHub repository
The workshop is being updated alongside the current FAST-HEP rewrite. Early tutorials are runnable now, while advanced sections on distributed execution, accelerators, and extensions are being completed as those interfaces stabilise.