Metadata-Version: 2.3
Name: alea-inference
Version: 0.3.2
Summary: A tool to perform toyMC-based inference constructions
Author: Alea contributors, the XENON collaboration
Requires-Python: >=3.8,<3.13
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Physics
Provides-Extra: docs
Requires-Dist: Jinja2 (==3.0.3) ; extra == "docs"
Requires-Dist: PyYAML
Requires-Dist: atomicwrites
Requires-Dist: blueice (>=1.2.1)
Requires-Dist: commonmark (==0.9.1) ; extra == "docs"
Requires-Dist: graphviz (==0.20.1) ; extra == "docs"
Requires-Dist: h5py
Requires-Dist: iminuit (>=2.21.0)
Requires-Dist: inference-interface
Requires-Dist: lxml_html_clean ; extra == "docs"
Requires-Dist: m2r (==0.2.1) ; extra == "docs"
Requires-Dist: matplotlib
Requires-Dist: mergedeep
Requires-Dist: mistune (==0.8.4) ; extra == "docs"
Requires-Dist: multihist
Requires-Dist: nbsphinx (==0.8.9) ; extra == "docs"
Requires-Dist: numpy
Requires-Dist: recommonmark (==0.7.1) ; extra == "docs"
Requires-Dist: scipy
Requires-Dist: sphinx (==5.2.3) ; extra == "docs"
Requires-Dist: sphinx_rtd_theme (==1.0.0) ; extra == "docs"
Requires-Dist: tqdm
Requires-Dist: utilix (>=0.11.0)
Project-URL: Repository, https://github.com/XENONnT/alea
Description-Content-Type: text/markdown

# alea
[![DOI](https://zenodo.org/badge/654100988.svg)](https://zenodo.org/badge/latestdoi/654100988)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/XENONnT/alea/HEAD?labpath=notebooks)
[![Test package](https://github.com/XENONnT/alea/actions/workflows/pytest.yml/badge.svg?branch=main)](https://github.com/XENONnT/alea/actions/workflows/pytest.yml)
[![Coverage Status](https://coveralls.io/repos/github/XENONnT/alea/badge.svg?branch=main&kill_cache=1)](https://coveralls.io/github/XENONnT/alea?branch=main&kill_cache=1)
[![PyPI version shields.io](https://img.shields.io/pypi/v/alea-inference.svg)](https://pypi.python.org/pypi/alea-inference/)
[![Readthedocs Badge](https://readthedocs.org/projects/alea/badge/?version=latest)](https://alea.readthedocs.io/en/latest/?badge=latest)
[![CodeFactor](https://www.codefactor.io/repository/github/xenonnt/alea/badge)](https://www.codefactor.io/repository/github/xenonnt/alea)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/XENONnT/alea/main.svg)](https://results.pre-commit.ci/latest/github/XENONnT/alea/main)

alea is a flexible statistical inference framework. The Python package is designed for constructing, handling, and fitting statistical models, computing confidence intervals and conducting sensitivity studies. It is primarily developed for the [XENONnT dark matter experiment](https://xenonexperiment.org/), but can be used for any statistical inference problem.

Alea aims to model the statistical behaviour of an experiment, which again depends on your knowledge of the underlying physics-- this can range from the very simple, such as measuring a gaussian-distributed random variable, to complex likelihoods where each model component is created by physics simulations (GEANT4), fast detector simulations (for example [appletree](https://github.com/XENONnT/appletree/) for XENONnT) or a data-driven method.

If you use alea in your research, please consider citing the software published on [zenodo](https://zenodo.org/badge/latestdoi/654100988).

## Installation
You can install alea from PyPI using pip but **beware that it is listed there as alea-inference!** Thus, you need to run
```
pip install alea-inference
```

For the latest version, you can install directly from the GitHub repository by cloning the repository and running
```
cd alea
pip install .
```
You are now ready to use alea!

## Getting started
The best way to get started is to check out the [documentation](https://alea.readthedocs.io/en/latest/) and have a look at our [tutorial notebooks](https://github.com/XENONnT/alea/tree/main/notebooks). To explore the notebooks interactively, you can use [Binder](https://mybinder.org/v2/gh/XENONnT/alea/HEAD?labpath=notebooks).

## Acknowledgements
`alea` is a public package inherited the spirits of previously private XENON likelihood definition and inference construction code `binference` that based on the blueice repo https://github.com/JelleAalbers/blueice.

Binference was developed for XENON1T WIMP searches by Knut Dundas Morå, and for the first XENONnT results by Robert Hammann, Knut Dundas Morå and Tim Wolf.

