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.6rc2.tar.gz (971.8 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.6rc2-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: equine-0.1.6rc2.tar.gz
  • Upload date:
  • Size: 971.8 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.6rc2.tar.gz
Algorithm Hash digest
SHA256 ea6795bc7220e01855a47c1765953d8c043c809229cb76887169efb3340a6dd6
MD5 92204411cdc8fdeb053a57be2e5b300e
BLAKE2b-256 022a3575943f2fde6ee72d2c6d6ad54bb640a336547ec7260697bd998d464923

See more details on using hashes here.

Provenance

The following attestation bundles were made for equine-0.1.6rc2.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.6rc2-py3-none-any.whl.

File metadata

  • Download URL: equine-0.1.6rc2-py3-none-any.whl
  • Upload date:
  • Size: 29.4 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.6rc2-py3-none-any.whl
Algorithm Hash digest
SHA256 55458f3e352941ab95653f0b1b6624bf82179bdfdba6024359dc50a28bdc13dc
MD5 0ff053f50dcf16e02d6537057329c217
BLAKE2b-256 e118ae48373d0cf37e5e6aefe084e3742093a239f96f3030a3dade94c76863a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for equine-0.1.6rc2-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