pyhf is a pure-python implementation of the widely-used HistFactory p.d.f. template described in [CERN-OPEN-2012-016]. It also includes interval estimation is based on the asymptotic formulas of “Asymptotic formulae for likelihood-based tests of new physics” [arxiv:1007.1727]. The aim is also to support modern computational graph libraries such as PyTorch and TensorFlow in order to make use of features such as autodifferentiation and GPU acceleration.

GitHub Project DOI JOSS DOI Scikit-HEP NSF-1836650 NumFOCUS Affiliated Project

Docs from latest Binder

PyPI version Conda Version Supported Python versionss

Code Coverage CodeFactor Code style: black

Coverage in the media

Recent Talks and Tutorials

SciPy 2020 talk YouTube

Projects using pyhf

An updating list of libraries, projects, and analyses that use pyhf are listed on the users projects repository.

Citations and Use in Publications

Updating list of citations (from use in analyses and general reference) of pyhf:

  • Oksana Shadura and Alexander Held. First performance measurements with the Analysis Grand Challenge. April 2023. arXiv:2304.05214.
  • Qilong Guo, Leyun Gao, Yajun Mao, and Qiang Li. Search for vector-like leptons at a Muon Collider. April 2023. arXiv:2304.01885.
  • Subhasish Behera, Manuel Hageluken, and Matthias Schott. Prospects of Searches for Anomalous Hadronic Higgs Boson Decays at the LHeC. Feb 2023. arXiv:2302.12885.
  • Jay Chan and Benjamin Nachman. Unbinned Profiled Unfolding. Feb 2023. arXiv:2302.05390.
  • Brian Bockelman, Peter Elmer, and Gordon Watts. IRIS-HEP Strategic Plan for the Next Phase of Software Upgrades for HL-LHC Physics. Feb 2023. arxiv:2302.01317
  • ATLAS Collaboration. Search for long-lived, massive particles in events with displaced vertices and multiple jets in pp collisions at s√=13 TeV with the ATLAS detector. Jan 2023. arXiv:2301.13866.
  • Nicolas Berger. Simplified likelihoods using linearized systematic uncertainties. Jan 2023. arXiv:2301.05676.
  • Florian Bury. Application of deep learning techniques in CMS: from matrix element regression to the search for Higgs boson pair production. PhD thesis, Université catholique de Louvain, Dec 2022 https://inspirehep.net/literature/2621189
  • Mohamed Aly et al. Second Analysis Ecosystem Workshop Report. Dec 2022. arxiv:2212.04889
  • Belle II Collaboration. Search for an invisible Z′ in a final state with two muons and missing energy at Belle II. Dec 2022. arXiv:2212.03066.
  • Matthew Feickert, Lukas Heinrich, and Giordon Stark. pyhf: a pure-Python statistical fitting library with tensors and automatic differentiation. PoS, ICHEP2022:245, Nov 2022. doi:10.22323/1.414.0245.
  • Alexander Held and Oksana Shadura. The IRIS-HEP Analysis Grand Challenge. PoS, ICHEP2022:235, Nov 2022. doi:10.22323/1.414.0235.
  • Lukas Allwicher, Darius. A. Faroughy, Florentin Jaffredo, Olcyr Sumensari, and Felix Wilsch. HighPT: A Tool for high-pT Drell-Yan Tails Beyond the Standard Model. Jul 2022. arXiv:2207.10756.
  • Belle Collaboration. Search for a dark leptophilic scalar produced in association with τ+τ− pair in e+e− annihilation at center-of-mass energies near 10.58 GeV. Jul 2022. arXiv:2207.07476.
  • Gaël Alguero, Jack Y. Araz, Benjamin Fuks, and Sabine Kraml. Signal region combination with full and simplified likelihoods in MadAnalysis 5. Jun 2022. arXiv:2206.14870.
  • Audrey Kvam. Search for Events with Two Displaced Vertices from Pair-Produced Neutral Long-Lived Particles Decaying to Hadronic Jets in the Muon Spectrometer of the ATLAS Detector with Full Run 2 Data. PhD thesis, Washington U., Seattle, Jun, 2022. https://cds.cern.ch/record/2812260.
  • ATLAS Collaboration. Search for heavy, long-lived, charged particles with large ionisation energy loss in pp collisions at s√=13 TeV using the ATLAS experiment and the full Run 2 dataset. May 2022. arxiv:2205.06013.
  • ATLAS Collaboration. SimpleAnalysis: Truth-level Analysis Framework. Apr 2022. https://cds.cern.ch/record/2805991.
  • Tommaso Dorigo et al. Toward the End-to-End Optimization of Particle Physics Instruments with Differentiable Programming: a White Paper. Mar 2022. arXiv:2203.13818.
  • Lucas Santiago Borgna. Search for pair production of Higgs Bosons decaying to four bottom quarks with data collected by the ATLAS detector. PhD thesis, University Coll. London, Mar, 2022. https://cds.cern.ch/record/2812193.
  • Alexander Albert et al. Strange quark as a probe for new physics in the Higgs sector. In 2022 Snowmass Summer Study. Mar 2022. arXiv:2203.07535.
  • Nathan Simpson and Lukas Heinrich. neos: End-to-End-Optimised Summary Statistics for High Energy Physics. Mar 2022. arXiv:2203.05570.
  • Harry Enke et al. Survey of Open Data Concepts Within Fundamental Physics: An Initiative of the PUNCH4NFDI Consortium. Computing and Software for Big Science, 6(1):6, Mar 2022. doi:10.1007/s41781-022-00081-7.
  • ATLAS Collaboration. Search for neutral long-lived particles in pp collisions at s√=13 TeV that decay into displaced hadronic jets in the ATLAS calorimeter. JHEP, 06:005, Jun 2022. arXiv:2203.01009, doi:10.1007/JHEP06(2022)005.
  • ATLAS Collaboration. Search for events with a pair of displaced vertices from long-lived neutral particles decaying into hadronic jets in the ATLAS muon spectrometer in pp collisions at s√=13 TeV. Mar 2022. arXiv:2203.00587.
  • Lukas Heinrich and Michael Kagan. Differentiable Matrix Elements with MadJax. Feb 2022. arXiv:2203.00057.
  • Jim Pivarski, Eduardo Rodrigues, Kevin Pedro, Oksana Shadura, Benjamin Krikler, and Graeme A. Stewart. HL-LHC Computing Review Stage 2, Common Software Projects: Data Science Tools for Analysis. Feb 2022. arXiv:2202.02194.
  • Florentin Jaffredo. Revisiting mono-tau tails at the LHC. Eur. Phys. J. C, 82(6):541, Jun 2022. arXiv:2112.14604, doi:10.1140/epjc/s10052-022-10504-9.
  • ATLAS Collaboration. Implementation of simplified likelihoods in HistFactory for searches for supersymmetry. Sep 2021. https://cds.cern.ch/record/2782654.
  • Michael J. Baker, Darius A. Faroughy, and Sokratis Trifinopoulos. Collider Signatures of Coannihilating Dark Matter in Light of the B-Physics Anomalies. Sep 2021. arXiv:2109.08689.
  • Kyle Cranmer and others. Publishing statistical models: Getting the most out of particle physics experiments. Sep 2021. arXiv:2109.04981.
  • Kyle Cranmer and Alexander Held. Building and steering binned template fits with cabinetry. EPJ Web Conf., 251:03067, 2021. doi:10.1051/epjconf/202125103067.
  • Jean-Loup Tastet, Oleg Ruchayskiy, and Inar Timiryasov. Reinterpreting the ATLAS bounds on heavy neutral leptons in a realistic neutrino oscillation model. July 2021. arXiv:2107.12980.
  • ATLAS Collaboration. Search for chargino–neutralino pair production in final states with three leptons and missing transverse momentum in s√=13 TeV pp collisions with the ATLAS detector. June 2021. arXiv:2106.01676.
  • Belle II Collaboration. Search for B⁺→ K⁺νν̅ decays using an inclusive tagging method at Belle II. Contribution to the 2021 EW session of the 55th Rencontres de Moriond. May 2021. arXiv:2105.05754.
  • Belle II Collaboration. Search for B⁺→ K⁺νν̅ decays using an inclusive tagging method at Belle II. Apr 2021. arXiv:2104.12624.
  • Andrei Angelescu, Damir Bečirević, Darius A. Faroughy, Florentin Jaffredo, and Olcyr Sumensari. On the single leptoquark solutions to the B-physics anomalies. Mar 2021. arXiv:2103.12504.
  • Matthew Feickert, Lukas Heinrich, Giordon Stark, and Ben Galewsky. Distributed statistical inference with pyhf enabled through funcX. EPJ Web Conf., 251:02070, 2021. arXiv:2103.02182, doi:10.1051/epjconf/202125102070.
  • Rodolfo Capdevilla, Federico Meloni, Rosa Simoniello, and Jose Zurita. Hunting wino and higgsino dark matter at the muon collider with disappearing tracks. Feb 2021. arXiv:2102.11292.
  • Vincenzo Cirigliano, Kaori Fuyuto, Christopher Lee, Emanuele Mereghetti, and Bin Yan. Charged Lepton Flavor Violation at the EIC. Feb 2021. arXiv:2102.06176.
  • Jack Y. Araz and others. Proceedings of the second MadAnalysis 5 workshop on LHC recasting in Korea. Mod. Phys. Lett. A, 36(01):2102001, 2021. arXiv:2101.02245, doi:10.1142/S0217732321020016.
  • Simone Amoroso, Deepak Kar, and Matthias Schott. How to discover QCD Instantons at the LHC. Eur. Phys. J. C, 81(7):624, Dec 2020. arXiv:2012.09120, doi:10.1140/epjc/s10052-021-09412-1.
  • Wolfgang Waltenberger, André Lessa, and Sabine Kraml. Artificial Proto-Modelling: Building Precursors of a Next Standard Model from Simplified Model Results. Dec 2020. arXiv:2012.12246, doi: 10.1007/JHEP03(2021)207.
  • Gaël Alguero, Jan Heisig, Charanjit K. Khosa, Sabine Kraml, Suchita Kulkarni, Andre Lessa, Philipp Neuhuber, Humberto Reyes-González, Wolfgang Waltenberger, and Alicia Wongel. New developments in SModelS. In Tools for High Energy Physics and Cosmology. Dec 2020. arXiv:2012.08192.
  • Matthew Feickert, Lukas Heinrich, and Giordon Stark. Likelihood preservation and statistical reproduction of searches for new physics. EPJ Web Conf., Nov 2020. doi:10.1051/epjconf/202024506017.
  • Gaël Alguero, Sabine Kraml, and Wolfgang Waltenberger. A SModelS interface for pyhf likelihoods. Sep 2020. arXiv:2009.01809.
  • ATLAS Collaboration. Search for new phenomena in events with two opposite-charge leptons, jets and missing transverse momentum in pp collisions at s√=13 TeV with the ATLAS detector. Geneva, Aug 2020. https://cds.cern.ch/record/2684863.
  • Jeffrey Krupa and others. GPU coprocessors as a service for deep learning inference in high energy physics. July 2020. arXiv:2007.10359.
  • Charanjit K. Khosa, Sabine Kraml, Andre Lessa, Philipp Neuhuber, and Wolfgang Waltenberger. SModelS database update v1.2.3. LHEP, 158:2020, May 2020. arXiv:2005.00555, doi:10.31526/lhep.2020.158.
  • Waleed Abdallah and others. Reinterpretation of LHC Results for New Physics: Status and Recommendations after Run 2. 2020. arXiv:2003.07868.
  • G. Brooijmans and others. Les Houches 2019 Physics at TeV Colliders: New Physics Working Group Report. In 2020. arXiv:2002.12220.
  • Andrei Angelescu, Darius A. Faroughy, and Olcyr Sumensari. Lepton Flavor Violation and Dilepton Tails at the LHC. Eur. Phys. J. C, 80(7):641, 2020. arXiv:2002.05684, doi:10.1140/epjc/s10052-020-8210-5.
  • B.C. Allanach, Tyler Corbett, and Maeve Madigan. Sensitivity of Future Hadron Colliders to Leptoquark Pair Production in the Di-Muon Di-Jets Channel. Eur. Phys. J. C, 80(2):170, 2020. arXiv:1911.04455, doi:10.1140/epjc/s10052-020-7722-3.
  • J. Alison and others. Higgs boson potential at colliders: status and perspectives. In 2019. arXiv:1910.00012.
  • ATLAS Collaboration. Reproducing searches for new physics with the ATLAS experiment through publication of full statistical likelihoods. Geneva, Aug 2019. https://cds.cern.ch/record/2684863.
  • Johann Brehmer, Felix Kling, Irina Espejo, and Kyle Cranmer. MadMiner: Machine learning-based inference for particle physics. Comput. Softw. Big Sci., 4(1):3, 2020. arXiv:1907.10621, doi:10.1007/s41781-020-0035-2.
  • Lukas Heinrich, Holger Schulz, Jessica Turner, and Ye-Ling Zhou. Constraining A₄ Leptonic Flavour Model Parameters at Colliders and Beyond. 2018. arXiv:1810.05648.

Published Probability Models

Updating list of HEPData entries for publications using HistFactory JSON statistical models. There is also an automatically generated list of statistical models that is updated nightly available at pyhf.github.io/public-probability-models.

  • Search for supersymmetry in final states with missing transverse momentum and three or more b-jets in 139 fb−1 of proton-proton collisions at s√=13 TeV with the ATLAS detector. 2022. doi:10.17182/hepdata.95928
  • Search for flavour-changing neutral-current couplings between the top quark and the photon with the ATLAS detector at s√=13 TeV. 2022. doi:10.17182/hepdata.129959
  • Searches for new phenomena in events with two leptons, jets, and missing transverse momentum in 139 fb−1 of s√=13 TeV pp collisions with the ATLAS detector. 2022. doi:10.17182/hepdata.116034
  • Search for Higgs boson pair production in the two bottom quarks plus two photons final state in pp collisions at s√=13 TeV with the ATLAS detector. 2021. doi:10.17182/hepdata.105864
  • Search for charginos and neutralinos in final states with two boosted hadronically decaying bosons and missing transverse momentum in pp collisions at s√=13 TeV with the ATLAS detector. 2021. doi:10.17182/hepdata.104458
  • Measurement of the tt̅tt̅ production cross section in pp collisions at s√=13 TeV with the ATLAS detector. 2021. doi:10.17182/hepdata.105039
  • Search for R-parity violating supersymmetry in a final state containing leptons and many jets with the ATLAS experiment using s√=13 TeV proton-proton collision data. 2021. doi:10.17182/hepdata.104860
  • Search for chargino–neutralino pair production in final states with three leptons and missing transverse momentum in s√=13 TeV pp collisions with the ATLAS detector. 2021. doi:10.17182/hepdata.95751
  • Measurements of the inclusive and differential production cross sections of a top-quark-antiquark pair in association with a Z boson at s√=13 TeV with the ATLAS detector. 2021. doi:10.17182/hepdata.100351
  • Search for pair production of third-generation scalar leptoquarks decaying into a top quark and a τ-lepton in pp collisions at s√=13 TeV with the ATLAS detector. 2021. doi:10.17182/hepdata.100174.
  • Search for squarks and gluinos in final states with one isolated lepton, jets, and missing transverse momentum at s√=13 TeV with the ATLAS detector. 2021. doi:10.17182/hepdata.97041
  • Search for trilepton resonances from chargino and neutralino pair production in s√=13 TeV pp collisions with the ATLAS detector. 2020. doi:10.17182/hepdata.99806.
  • Search for displaced leptons in s√=13 TeV pp collisions with the ATLAS detector. 2020. doi:10.17182/hepdata.98796.
  • Search for squarks and gluinos in final states with jets and missing transverse momentum using 139 fb−1 of s√=13 TeV pp collision data with the ATLAS detector. 2020. doi:10.17182/hepdata.95664.
  • Measurement of the tt̅ production cross-section in the lepton+jets channel at s√=13 TeV with the ATLAS experiment. 2020. doi:10.17182/hepdata.95748.
  • Search for long-lived, massive particles in events with a displaced vertex and a muon with large impact parameter in pp collisions at s√=13 TeV with the ATLAS detector. 2020. doi:10.17182/hepdata.91760
  • Search for chargino-neutralino production with mass splittings near the electroweak scale in three-lepton final states in s√ = 13 TeV pp collisions with the ATLAS detector. 2019. doi:10.17182/hepdata.91127.
  • Searches for electroweak production of supersymmetric particles with compressed mass spectra in s√=13 TeV pp collisions with the ATLAS detector. 2019. doi:10.17182/hepdata.91374
  • Search for direct stau production in events with two hadronic τ-leptons in s√=13 TeV pp collisions with the ATLAS detector. 2019. doi:10.17182/hepdata.92006.
  • Search for direct production of electroweakinos in final states with one lepton, missing transverse momentum and a Higgs boson decaying into two b-jets in (pp) collisions at s√=13 TeV with the ATLAS detector. 2019. doi:10.17182/hepdata.90607.
  • Search for squarks and gluinos in final states with same-sign leptons and jets using 139 fb−1 of data collected with the ATLAS detector. 2019. doi:10.17182/hepdata.91214.
  • Search for bottom-squark pair production with the ATLAS detector in final states containing Higgs bosons, b-jets and missing transverse momentum. 2019. doi:10.17182/hepdata.89408.

Team

Presentations

Publications