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.7.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.7-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: equine-0.1.7.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.7.tar.gz
Algorithm Hash digest
SHA256 14b3cbb096a009ea5292fc22dca3335b6126a1c6366520e7f57f4d4a735df54e
MD5 f3cc99867d8c0b88aaca0ad7e0ffb2f3
BLAKE2b-256 c6f60fbf395553cb905b0a5595e9ec678e7e0a568c4ac8ca7d00e7f2e43f5ae7

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: equine-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 29.2 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 3e0653a9449fc98ef75524b445dd5d5431cbffa3ba2ae12e8d58bd63c17d68d3
MD5 b394a8726efd654926dcb0a61cc33a35
BLAKE2b-256 e65dd151f78c55b0391c6e29596271d6dba8bdea8261d6dd0612bb949f2f381b

See more details on using hashes here.

Provenance

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