tensiometer 1.1.0

Tension tools for posterior distributions

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), 2409.09101 (synthetic probability and posterior profiles)

Description

Tensiometer is a collection of tools to help understand 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:

• Normalizing flow models for posterior distributions;

• Tension between two Gaussian posteriors;

• Tension between two non-Gaussian posteriors;

• Posterior profiles;

• Measured parameters;

• Quantify convergence of chains;

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

Documentation build

To refresh the example notebook HTML outputs before building the docs, run:

make prepare_examples

Then build the documentation locally with:

make documentation

Acknowledgements

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