Skip to main content

The place for all your prior elicitation needs.

Project description

A tool-box for prior elicitation.

PyPi version Build Status codecov Code style: black DOI

Overview

Prior elicitation refers to the process of transforming the knowledge of a particular domain into well-defined probability distributions. Specifying useful priors is a central aspect of Bayesian statistics. PreliZ is a Python package aimed at helping practitioners choose prior distributions by offering a set of tools for the various facets of prior elicitation. It covers a range of methods, from unidimensional prior elicitation on the parameter space to predictive elicitation on the observed space. The goal is to be compatible with probabilistic programming languages (PPL) in the Python ecosystem like PyMC and PyStan, while remaining agnostic of any specific PPL.

The Zen of PreliZ

  • Being open source, community-driven, diverse and inclusive.
  • Avoid fully-automated solutions, keep the human in the loop.
  • Separate tasks between humans and computers, so users can retain control of important decisions while numerically demanding, error-prone or tedious tasks are automatized.
  • Prevent users to become overconfident in their own opinions.
  • Easily integrate with other tools.
  • Allow predictive elicitation.
  • Having a simple and intuitive interface suitable for non-specialists in order to minimize cognitive biases and heuristics.
  • Switching between different types of visualization such as kernel density estimates plots, quantile dotplots, histograms, etc.
  • Being agnostic of the underlying probabilistic programming language.
  • Being modular.

Documentation

The PreliZ documentation can be found in the official docs.

Installation

Last release

PreliZ is available for installation from PyPI. The latest version (base set of dependencies) can be installed using pip:

pip install preliz

To make use of the interactive features, you can install the optional dependencies:

  • For JupyterLab:
pip install "preliz[full,lab]"
  • For Jupyter Notebook:
pip install "preliz[full,notebook]"

Development

The latest development version can be installed from the main branch using pip:

pip install git+git://github.com/arviz-devs/preliz.git

Citation

If you find PreliZ useful in your work, we kindly request that you cite the following paper:

@article{Icazatti_2023,
author = {Icazatti, Alejandro and Abril-Pla, Oriol and Klami, Arto and Martin, Osvaldo A},
doi = {10.21105/joss.05499},
journal = {Journal of Open Source Software},
month = sep,
number = {89},
pages = {5499},
title = {{PreliZ: A tool-box for prior elicitation}},
url = {https://joss.theoj.org/papers/10.21105/joss.05499},
volume = {8},
year = {2023}
}

Contributions

PreliZ is a community project and welcomes contributions. Additional information can be found in the Contributing Readme

Code of Conduct

PreliZ wishes to maintain a positive community. Additional details can be found in the Code of Conduct

Donations

PreliZ, as other ArviZ-devs projects, is a non-profit project under the NumFOCUS umbrella. If you want to support PreliZ financially, you can donate here.

Sponsors

NumFOCUS

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

preliz-0.3.5.tar.gz (56.8 kB view details)

Uploaded Source

Built Distribution

preliz-0.3.5-py2.py3-none-any.whl (75.2 kB view details)

Uploaded Python 2Python 3

File details

Details for the file preliz-0.3.5.tar.gz.

File metadata

  • Download URL: preliz-0.3.5.tar.gz
  • Upload date:
  • Size: 56.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for preliz-0.3.5.tar.gz
Algorithm Hash digest
SHA256 80eaf02006de19583d9f122be6bdb01b890f9a464137a795543d6fdc4342e8e6
MD5 899a656c4442ca289da68bfef317ed3d
BLAKE2b-256 94a7a7a5fb4c9022a3372841ca89fea718a3ee4963e6885ec9ccc2a4d862e788

See more details on using hashes here.

File details

Details for the file preliz-0.3.5-py2.py3-none-any.whl.

File metadata

  • Download URL: preliz-0.3.5-py2.py3-none-any.whl
  • Upload date:
  • Size: 75.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for preliz-0.3.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c611e32cdddf832cb900ec6ee1b7da3db7c3eb9ed13ce5703fd9aac5db3b542b
MD5 ddc9de5f6e22dc380b841252840bbc15
BLAKE2b-256 bf7121e62b5fbc6e1bd8be0b8f4afdcd4c529f4781de4a7cad1a7d3b99357a05

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page