v1.5.0

[From November 17th 2025]

Added

• Ionizing Signature for MCPs
• Option to export multiple disconnected lines in foresee.extract_contours()

Changed

• added 'configuration' option for model.add_production_direct() to allow using multiple files/configurations to estimate uncertainties for direct production modes

Fixed

• fix bug in utility.widths()
• fix bug in model.set_ctau_2d() and model.set_br_2d(), which led to a return error
• fix bug in model.get_production_scaling()
• fix bug in foresee.get_events() and foresee.get_events_interaction() to ensure separate "cfacs" for different for channels
• fix bug in utility.convert_to_hist_list() when calculating px when momenta is a numpy array (which should usually not occur). Many thanks to M. Hostert for finding it.
• fix bug of undefined 'mass' in foresee.decay_in_restframe_3body() when when integration == chain_decay.
• fix failure in foresee.write_events() when pz=0

Models and Examples

• added Bremsstrahlung production files to MCPs (using FWW approximation)
• added 2HDM model
• added 2024 BESIII bounds to ALP-photon model
• update constraints on U(1)B model
• added ICARUS bounds to Dark Higgs model
• added new Bremsstrahlung files for dark photon, U1B, U1B-L and MCP model
• added new dark photon lifetime and BR following 2201.01788
• added dark photon plus dark Higgs model
• added FORMOSA reach

v1.4.0

[From June 5th 2024]

Added

• added documentation/docstrings
• added unit tests (for Utility class, FORESEE class, Dark Photon Model, MCP Model)
• possibility of 1-body LLP decays (conversion)

Changed

• restructure code: move functions associated with reading spectra files to UTILITY class
• restructure code: move all functions associated to modeling of decays to DECAY class
• restructure code: split foresee.get_spectrum() in multiple functions
• optimize performance of get_events() function by using more list comprehensions
• optimize performance of get_events() function by pre-compiling eval(selection) and eval(efficiency)
• optimize performance of get_events_interaction() function by using more list comprehensions

Fixed

• modified format of SIBYLL 14TeV spectra to agree with those other spectra

Models and Examples

• update ALP-g branching fractions (now extend to 1.2 GeV)
• add updated bounds for HNL models

v1.3.2

[From Mai 10th 2024]

Added

• tau lepton spectra (obtained from Ds spectra) for various generators
• plotting function foresee.plot_production_branchings()
• integration variable in foresee add_production_3bodydecay()
• more flexibility to implement 3-body decays into LLPs by providing different differential decay BR

Models and Examples

• HNL models and HNLCalc library

v1.3.1

[From Apr 19th 2024]

Changed

• add PDG python library for particle masses/charges
• add plotting function for irregular grids (not recommended, mainly for testing)
• add efficiency option to detector setup

Fixed

• bug fix in ALP-LSW

Models and Examples

• added NA62 and FASER bounds for the DarkPhoton model
• implement crossing angle in ALP-LSW

v1.3.0

[From Dec 13th 2023]

Changed

• add line-width option to foresee.plot_reach()
• allow mixing in model.add_production_mixing() to be a function
• add distance_prod variable option to foresee.set_detector() specifying the production location

Removed

• remove unused decaychannels variable from foresee.write_events()

Fixed

• warning with dtype='object'
• fix bug in write_events

Models and Examples

• Update format of Model Notebooks in Model Library
• update various bounds
• Add dedicated Tutorial
• add ALP-g model
• fix BR into pions in the up-philic scalar model

v1.2.1

[From Nov 22th 2023]

Added

• added functionality to simulate 3body LLP decay kinematics (following a pure phase space sampling) when writing HEPMC files

v1.2.0

[From Nov 22th 2023]

Added

• "generator option" in model.add_production can now take list of generators
• added functionality to store multiple events weights for different generators/configurations.
• foresee.write_events() can now write HEPMC files with multiple event weights.

Changed

• update FORESEE.plot_production() function

Models and Examples

• Added DarkPhotonUncertainty example, which shows how to deal with systematics.

v1.1.8

[From Nov 22th 2023]

Added

• use numba package to speed up foresee.get_llp_spectrum()
• add nsample_had option to foresee.add_production functions

Changed

• various internal function changes to make FORESEE more efficient

Deprecated

• print_stats option in foresee.get_llp_spectrum()

v1.1.7

[From Sept 8th 2023]

Added

• add bottom/charm spectra at 13.6 and 14 TeV obtained at NLO with POWHEG + Pythia8
• add light/charm particle spectra from default Pythia and the dedicated Pythia forward tune at 13.6 TeV
• add new foresee.plot_production() function

Changed

• allow to combine different channels in foresee.plot_production()

Models and Examples

• add LLP decays branching fractions for up-philic scalar
• add U(1)B model

v1.1.6

[From April 20th 2023]

Added

• add more 13.6 TeV particle spectra for (B-hadrons from Pythia, ALPs from Primakoff production)

Models and Examples

• added U(1)B-L model