Skip to main content

EQUINE^2: Establishing Quantified Uncertainty for Neural Networks

Project description

Establishing Quantified Uncertainty in Neural Networks

PyPi Build Status python_passing_tests python_coverage Code style: black Tested with Hypothesis DOI

Usage

Deep neural networks (DNNs) for supervised labeling problems are known to produce accurate results on a wide variety of learning tasks. However, when accuracy is the only objective, DNNs frequently make over-confident predictions, and they also always make a label prediction regardless of whether or not the test data belongs to any known labels.

EQUINE was created to simplify two kinds of uncertainty quantification for supervised labeling problems:

  1. Calibrated probabilities for each predicted label
  2. An in-distribution score, indicating whether any of the model's known labels should be trusted.

Dive into our documentation examples to get started. Additionally, we provide a companion web application.

Installation

Users are recommended to install a virtual environment such as Anaconda, as is also recommended in the pytorch installation. EQUINE has relatively few dependencies beyond torch.

pip install equine

Users interested in contributing should refer to CONTRIBUTING.md for details.

Design

EQUINE extends pytorch's nn.Module interface using a predict method that returns both the class predictions and the extra OOD scores.

Disclaimer

DISTRIBUTION STATEMENT A. Approved for public release. Distribution is unlimited.

© 2024 MASSACHUSETTS INSTITUTE OF TECHNOLOGY

  • Subject to FAR 52.227-11 – Patent Rights – Ownership by the Contractor (May 2014)
  • SPDX-License-Identifier: MIT

This material is based upon work supported by the Under Secretary of Defense for Research and Engineering under Air Force Contract No. FA8702-15-D-0001. Any opinions, findings, conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the Under Secretary of Defense for Research and Engineering.

The software/firmware is provided to you on an As-Is basis.

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

equine-0.1.6.tar.gz (971.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

equine-0.1.6-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file equine-0.1.6.tar.gz.

File metadata

  • Download URL: equine-0.1.6.tar.gz
  • Upload date:
  • Size: 971.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for equine-0.1.6.tar.gz
Algorithm Hash digest
SHA256 d2d078bb05a6338052ce0b2b1b682265c893c61bc6213f75768563b54197decb
MD5 0349a1d68f80c55d84d3c25976a0cc85
BLAKE2b-256 8185fc932f8ebe27be050e305d8488e6ba8e4c017c7bbccf01bd742b2b2852bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for equine-0.1.6.tar.gz:

Publisher: python-publish.yml on mit-ll-responsible-ai/equine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file equine-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: equine-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for equine-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 efcb56aeda75dc04882748c013a1c1dd22781cdf2924cd6c6b4c3e7816e609d8
MD5 b9f7e26cc4509611accfb58da0f6e5ae
BLAKE2b-256 4c372152fe0fceb47a00feb4272b24ee3aa882d80f8bf675b6cb6d7522801c74

See more details on using hashes here.

Provenance

The following attestation bundles were made for equine-0.1.6-py3-none-any.whl:

Publisher: python-publish.yml on mit-ll-responsible-ai/equine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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