ALP processes
Functions
- alpaca.branching_ratio(transition: str, ma: float, couplings: ALPcouplings, fa: float, br_dark: float = 0.0, **kwargs) float
Calculate the branching ratio for a given transition.
Parameters
- transition (str)
The particle transition in the form ‘initial -> final’.
- ma (float) :
The mass of the ALP, in GeV.
- couplings (ALPcouplings) :
The couplings of the ALP to other particles.
- fa (float):
The decay constant of the ALP, in GeV.
- br_dark (float, optional):
The branching ratio to dark sector particles. Default is 0.0.
- **kwargs:
Additional parameters for the branching ratio calculation.
Returns
- BR (float) :
The branching ratio for the specified transition.
Raises
NotImplementedError: If the decay process is unknown.
- alpaca.decay_width(transition: str, ma: float, couplings: ALPcouplings, fa: float, br_dark: float = 0.0, **kwargs) float
Calculate the decay width for a given transition.
Parameters
- transition (str)
The particle transition in the form ‘initial -> final’.
- ma (float) :
The mass of the ALP, in GeV.
- couplings (ALPcouplings) :
The couplings of the ALP to other particles.
- fa (float):
The decay constant of the ALP, in GeV.
- br_dark (float, optional):
The branching ratio to dark sector particles. Default is 0.0.
- **kwargs:
Additional parameters for the decay width calculation.
Returns
- Gamma (float) :
The decay width for the specified transition, in GeV.
Raises
NotImplementedError: If the decay process is unknown.
- alpaca.cross_section(transition: str, ma: float, couplings: ALPcouplings, s: float, fa: float, br_dark=0, **kwargs) float
Calculate the cross section for a given transition process involving an ALP
Parameters
- transition (str) :
The transition process in the form ‘initial -> final’.
- ma (float) :
The mass of the ALP, in GeV.
- couplings (ALPcouplings) :
The couplings of the ALP to other particles.
- s (float) :
The Mandelstam variable s, representing the square of the center-of-mass energy, in Gev^2.
- fa (float) :
The decay constant of the ALP, in GeV.
- br_dark (float, optional) :
The branching ratio to dark sector particles. Default is 0.
- **kwargs:
Additional keyword arguments for specific cross section calculations.
Returns
- sigma (float) :
The calculated cross section for the given transition process.
Raises
NotImplementedError: If the transition process is not recognized or implemented.
- alpaca.meson_mixing(obs: str, ma: float, couplings: ALPcouplings, fa: float, **kwargs) float
Obtains the value of a meson mixing observable.
Parameters
- obsstr
The observable to calculate. The available options are: - ‘delta_mK0’: The mass difference of the K0 meson, in ps^{-1}. - ‘epsK’: The epsilon parameter of the K0 meson. - ‘x_D0’: Normalized mass difference in D0 mixing. - ‘phi12_D0’: D0 mixing phase, in rad. - ‘delta_mB0’: The mass difference of the B0 meson, in ps^{-1}. - ‘delta_mBs’: The mass difference of the Bs meson, in ps^{-1}.
- mafloat
The mass of the ALP, in GeV.
- couplingsALPcouplings
The couplings of the ALP to other particles.
- fafloat
The decay constant of the ALP, in GeV.
- alpaca.alp_channels_branching_ratios(ma: float, couplings: ALPcouplings, fa: float, br_dark: float = 0.0, **kwargs) dict[str, float]
Calculate the branching ratios for all ALP decay channels.
Parameters
- ma (float) :
The mass of the ALP, in GeV.
- couplings (ALPcouplings) :
The couplings of the ALP to other particles.
- fa (float):
The decay constant of the ALP, in GeV.
- br_dark (float, optional):
The branching ratio to dark sector particles. Default is 0.0.
- **kwargs:
Additional parameters for the branching ratio calculation.
Returns
- dict[str, float] :
A dictionary with decay channels as keys and their corresponding branching ratios as values.
- alpaca.alp_channels_decay_widths(ma: float, couplings: ALPcouplings, fa: float, br_dark: float = 0.0, **kwargs) dict[str, float]
Calculate the decay widths for all ALP decay channels.
Parameters
- ma (float) :
The mass of the ALP, in GeV.
- couplings (ALPcouplings) :
The couplings of the ALP to other particles.
- fa (float):
The decay constant of the ALP, in GeV.
- br_dark (float, optional):
The branching ratio to dark sector particles. Default is 0.0.
- **kwargs:
Additional parameters for the decay width calculation.
Returns
- dict[str, float] :
A dictionary with decay channels as keys and their corresponding widths as values.