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

v1.1.5

[From March 2nd 2023]

Added

• include LICENSE file

Changed

• expand gitignore
• update README file

Removed

• remove many unnecessary files (such as the ones in the models events, results and LLP_spectra subdirectories) to reduce the size of the package

Models and Examples

• update dark photon bounds according to those available in DarkCast v2.0