tensiometer

Tension tools for posterior distributions


Keywords
MCMC
License
GPL-2.0+
Install
pip install tensiometer==0.0.8

Documentation

Tensiometer

Test a model until it breaks!

Tensiometer: A tool to test the level of agreement/disagreement between high dimensional posterior distributions.
Author: Marco Raveri and Cyrille Doux
Homepage: https://tensiometer.readthedocs.io
Source: https://github.com/mraveri/tensiometer
References: 2105.03324 (non-Gaussian tension metrics), 1806.04649 and 1912.04880 (Gaussian tension metrics), 2112.05737 (measured parameters).
https://readthedocs.org/projects/tensiometer/badge/?version=latest https://coveralls.io/repos/github/mraveri/tensiometer/badge.svg?branch=master https://img.shields.io/pypi/v/tensiometer.svg?style=flat

Description

The tensiometer package is a collection of tools to help understanding the structure of high dimensional posterior distributions. In particular it implements a number of metrics to quantify the level of agreement/disagreement between different distributions. Some of these methods are based on a Gaussian approximation. Others are capable of capturing non-Gaussian features of the distributions thanks to machine learning techniques.

The best way to get up to speed is to walk through some worked example, based on what is needed:

Installation

The tensiometer package is available on PyPI and can be easily installed with:

pip install tensiometer

Alternatively one can download the source code from github:

git clone https://github.com/mraveri/tensiometer.git

and install it locally with the shortcut:

make install

You can test that the code is working properly by using:

make test

Dependencies

Tensiometer uses mostly standard python packages. Notable exceptions are GetDist, Tensorflow and Tensorflow Probability. Installing the last two is likely painful and we advice to not delegate that to automatic dependency resolvers...

For the full list of requirements see the requirements.txt file.

Testing the code

Tensiometer has a suite of unit tests to make sure everything is properly installed. This is especially useful considering that tensiometer relies on a number of external libraries.

To run all tests give the command:

make test

To run tests and get coverage statistics first make sure that the package coverage is installed. Then you can use the command:

make test_with_coverage

As you can see coverage is not complete, pull requests improving test coverage are most welcome.

Documentation

The documentation is automatically built for each release on readthedocs.

If you want to build locally the documentation you shoud install sphinx. Then you can install the readthedocs documentation format with:

pip install sphinx-rtd-theme

Then you can issue the command:

make documentation

Acknowledgements

We thank Samuel Goldstein, Shivam Pandey for help developing the code.