maxwent 0.3.0

Maximum Weight Entropy

MaxWEnt

Maximum Weight Entropy

This repository offers a packaged implementation of MaxWEnt, based on the original method described in Deep Out-of-Distribution Uncertainty Quantification via Weight Entropy Maximization (JMLR)

---

MaxWEnt is a method designed for epistemic uncertainty quantification in deep learning. It applies the Maximum Entropy principle to stochastic neural networks. The goal of MaxWEnt is to determine the weight distribution with the highest entropy that remains consistent with the training observations. By doing so, the method enhances the epistemic uncertainty, which generally leads to improved detection of out-of-distribution samples.

Regression Example

Classification Example

Installation and Usage

This package is available on Pypi and can be installed with the following command line:

pip install maxwent

You will need either Tensorflow or Pytorch to be installed. If both packages are installed, the Tensorflow framework of maxwent will be used by default.

To change the framework, please use the set_framework function:

• Pytorch framework

import maxwent
maxwent.set_framework("torch")

• Tensorflow framework

import maxwent
maxwent.set_framework("tf")

Reference

If you use this repository in your research, please cite our work using the following reference:

@article{JMLR:v26:23-1359,
  author  = {Antoine de Mathelin and Fran{\c{c}}ois Deheeger and Mathilde Mougeot and Nicolas Vayatis},
  title   = {Deep Out-of-Distribution Uncertainty Quantification via Weight Entropy Maximization},
  journal = {Journal of Machine Learning Research},
  year    = {2025},
  volume  = {26},
  number  = {4},
  pages   = {1--68},
  url     = {http://jmlr.org/papers/v26/23-1359.html}
}