HH → bb̄ττ

This is the documentation for the HH→bb̄ττ analysis — the search for Higgs-boson pair production in the bb̄ττ final state. It is the reference analysis of the FLAF framework and the most feature-complete.

The common workflow lives in the FLAF docs

HH→bb̄ττ runs on FLAF, so the installation model, the task pipeline (NanoAOD → anaTuples → histograms → plots), the configuration system, storage, eras and CI are the same as for every FLAF analysis and are documented once, in the FLAF documentation:

• Prerequisites & installation
• Your first run
• Full workflow walkthrough
• Command arguments

This site covers only what is specific to HH→bb̄ττ.

What this analysis adds on top of FLAF

Ingredient	Purpose
SVfit (ClassicSVfit, SVfitTF)	Reconstruct the di-τ system mass.
HHKinFit2	Kinematic fit of the HH system.
HHbtag	HH-optimised b-jet identification.
DeepTau	τ identification; the version is selectable (2p1/2p5).
Resonant + non-resonant signals	Radion (spin-0) & Bulk Graviton (spin-2); ggF & VBF non-resonant.
StatInference	Datacards, resonant & non-resonant limits, pulls & impacts.

The setup of these pieces is in Setup; how they enter a run is in Running the analysis; the statistics step is in Statistical inference.

Quickstart

git clone --recursive git@github.com:cms-flaf/HH_bbtautau.git
cd HH_bbtautau
source env.sh                                  # first time builds the environment
voms-proxy-init -voms cms -rfc -valid 192:00
law index --verbose

Then smoke-test the whole chain (see FLAF → first run):

law run FLAF.Analysis.tasks.HistPlotTask \
  --version my_first_run --period Run3_2022 --workflow local --branches 0 --test 1000

New to FLAF? Read Key terms and the Concepts section first.

Eras

HH→bb̄ττ currently runs over the Run 3 eras Run3_2022, Run3_2022EE, Run3_2023 and Run3_2023BPix. See FLAF → Eras.