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.5rc1.tar.gz (969.9 kB view details)

Uploaded Source

Built Distribution

equine-0.1.5rc1-py3-none-any.whl (27.5 kB view details)

Uploaded Python 3

File details

Details for the file equine-0.1.5rc1.tar.gz.

File metadata

  • Download URL: equine-0.1.5rc1.tar.gz
  • Upload date:
  • Size: 969.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for equine-0.1.5rc1.tar.gz
Algorithm Hash digest
SHA256 270f0081f32f6f01dc747893a44367d7087f1b9c679a2e26a2c60120702473ad
MD5 6873371d36f64d9a6ec8f52ccb99f6bc
BLAKE2b-256 74d425f0bfe82e13abf15679d17f882420c1b14bc7dc0b7f58fbede496486082

See more details on using hashes here.

File details

Details for the file equine-0.1.5rc1-py3-none-any.whl.

File metadata

  • Download URL: equine-0.1.5rc1-py3-none-any.whl
  • Upload date:
  • Size: 27.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for equine-0.1.5rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 759810058f29c9e133a2a5991f3d289d82a8397cbbed6f75833257ceb7dd5767
MD5 28cc0fbc6e80b93112d4d6cacc3f615c
BLAKE2b-256 c2ed3c55611b814c234553fc4dfda111ffb7c733e5131eed2b07ffc49f1bc395

See more details on using hashes here.

Supported by

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