SciPost logo

SciPost Submission Page

pyBumpHunter: A model independent bump hunting tool in Python for High Energy Physics analyses

by Louis Vaslin, Samuel Calvet, Vincent Barra, Julien Donini

This is not the latest submitted version.

Submission summary

Authors (as registered SciPost users): Louis Vaslin
Submission information
Preprint Link:  (pdf)
Code repository:
Date submitted: 2023-03-06 16:23
Submitted by: Vaslin, Louis
Submitted to: SciPost Physics Core
Ontological classification
Academic field: Physics
  • High-Energy Physics - Experiment
Approach: Experimental


The BumpHunter algorithm is widely used in the search for new particles in High Energy Physics analysis. This algorithm offers the advantage of evaluating the local and global p-values of a localized deviation in the observed data without making any hypothesis on the supposed signal. The increasing popularity of the Python programming language motivated the development of a new public implementation of this algorithm in Python, called pyBumpHunter, together with several improvements and additional features. It is the first public implementation of the BumpHunter algorithm to be added to Scikit-HEP. This paper presents in detail the BumpHunter algorithm as well as all the features proposed in this implementation. All these features have been tested in order to demonstrate their behaviour and performance.

List of changes

Added the modification requested by the editorial report.

Current status:
Has been resubmitted

Reports on this Submission

Report 1 by Mohamed Rameez on 2023-3-28 (Invited Report)


In addition to the strengths mentioned in the previous round of review, the inclusion of more comprehensive references makes the paper overall more readable now. The addition of figure 8 also improves the readability of the paper.


The text itself is just an accompaniment to the code and tool.


Perhaps this manuscript is better suited for Scipost physics codebases? I leave this to the editor to decide.

Requested changes

The author says "Using a mean+-68% interval (1 sigma) would indeed make more sense and this feature will be added to future releases of pyBumpHunter.
However we decided to keep this description in the paper since it corresponds to what the current stable release of pyBumpHunter does."

Perhaps this should be emphasized in text? That a nonstandard definition of uncertainties is being used.

  • validity: good
  • significance: good
  • originality: ok
  • clarity: high
  • formatting: good
  • grammar: excellent

Author:  Louis Vaslin  on 2023-04-06  [id 3560]

(in reply to Report 1 by Mohamed Rameez on 2023-03-28)
answer to question

Thank you again for your feedback.

We agree that one the main purpose of this paper is to present in details the features proposed in the pyBumpHunter package.
If it is more pertinent to have it in SciPost Physics codebases, we have no objections.

Concerning the nonstandard definition of uncertainties in section 2, we added a sentence in the caption of figure 4 :
"This is a nonstandard definition of uncertainties that will be modified in future release to cover a 68% confidence interval corresponding to 1σ."

Here is the link to the last version on arXiv :

Best regards,

Louis Vaslin, for the authors

Login to report or comment