alpaca.experimental_data

Classes

class alpaca.experimental_data.classes.MeasurementBase(inspire_id: str, decay_type: str, rmin: float | None = None, rmax: float | None = None, lab_boost: float = 0.0, mass_parent: float = 0.0, mass_sibling: float = 0.0, bibtex: dict[str, str] | None = None)

Base class for measurements. This class provides a common interface for different types of measurements. It is not intended to be instantiated directly.

Attributes:

inspire_id (str): Inspire-HEP reference of the measurement. decay_type (str): The decay_type of the instance. rmin (float|None): The minimum length of the detector. rmax (float|None): The maximum length of the detector. initiated (bool): Indicates if the instance has been initiated. lab_boost (float): The laboratory boost value. mass_parent (float): The mass of the parent. mass_sibling (float): The mass of the sibling. conf_level (float|None): The confidence level of the measurement.

Methods:

initiate(): Initializes the instance by registering the Inspire-HEP reference. get_central(ma: float|None, ctau: float|None): Returns the central value of the measurement. get_sigma_left(ma: float|None, ctau: float|None): Returns the left sigma of the measurement. get_sigma_right(ma: float|None, ctau: float|None): Returns the right sigma of the measurement. decay_probability(ctau: float|None, ma: float|None, br_dark: float=0.0): Calculates the decay probability for a given mass and ctau.

decay_probability(ctau: float | None = None, ma: float | None = None, br_dark: float = 0.0, theta: float | None = None) float

Calculate the probability for the decay of the alp corresponding to the decay_type.

Parameters

ctaufloat | None

The proper length of the alp, in cm.

mafloat | None

The mass of the alp, in GeV.

br_darkfloat

The branching ratio of decay into the dark sector.

get_central(ma: float | None = None, ctau: float | None = None) float

Get the central value of the measurement.

Parameters

mafloat | None

The mass of the alp, in GeV.

ctaufloat | None

The proper length of the alp, in cm.

get_sigma_left(ma: float | None = None, ctau: float | None = None) float

Get the left one-sided uncertainty of the measurement. In the case of an upper limit bound, this is zero.

Parameters

mafloat | None

The mass of the alp, in GeV.

ctaufloat | None

The proper length of the alp, in cm.

get_sigma_right(ma: float | None = None, ctau: float | None = None) float

Get the right one-sided uncertainty of the measurement.

Parameters

mafloat | None

The mass of the alp, in GeV.

ctaufloat | None

The proper length of the alp, in cm.

Functions

alpaca.experimental_data.get_measurements(process: str | tuple, exclude_projections: bool = True) dict[str, MeasurementBase]

Retrieve measurements based on the given transition.

Parameters

transitionstr

The particle transition in the format ‘initial -> final’.

exclude_projectionsbool

Flag to exclude projection measurements. Defaults to True.

Returns

measurementsdict[str, MeasurementBase]

A dictionary mapping experiment names to their corresponding measurement data.

Raises

KeyError

If no measurements are found for the given transition.