Tensiometer
==================================

tensiometer is a python package to test the level of agreement/disagreement between different posterior distributions.

In order to do so the package contains a set of tools implementing machine learning methods to boost classic statistical inference.

The code is distributed under GNU-GPL license at `github <https://github.com/mraveri/tensiometer>`_.

The best place to start is by looking at the worked examples below.

.. toctree::
   :maxdepth: 2
   :caption: Examples

   Normalizing flow models for posterior distributions <https://tensiometer.readthedocs.org/en/latest/example_synthetic_probability.html>
   Tension between two Gaussian posteriors <https://tensiometer.readthedocs.org/en/latest/example_gaussian_tension.html>
   Tension between two non-Gaussian posteriors <https://tensiometer.readthedocs.org/en/latest/example_non_gaussian_tension.html>
   Posterior profiles <https://tensiometer.readthedocs.org/en/latest/example_posterior_profiles.html>
   Measured parameters <https://tensiometer.readthedocs.org/en/latest/example_measured_parameters.html>
   Quantify convergence of chains <https://tensiometer.readthedocs.org/en/latest/example_chains_convergence_test.html>

These example notebooks contain a discussion of the core functionalities of the code. 
All are illustrated with physics examples.

.. toctree::
   :maxdepth: 1
   :caption: Modules documentation

   synthetic_probability
   mcmc_tension
   gaussian_tension
   chains_convergence
   utilities
   interfaces

Full documentation for the modules.

* :ref:`genindex`