Repository files navigation

This repository reproduces representative methods within theGeneralized Out-of-Distribution Detection Framework,aiming to make a fair comparison across methods that were initially developed for anomaly detection, novelty detection, open set recognition, and out-of-distribution detection.This codebase is still under construction.Comments, issues, contributions, and collaborations are all welcomed!

Timeline of the methods that OpenOOD supports. More methods are included as OpenOOD iterates.

• 06 Nov, 2024: OpenOODv1.5 full paper is accepted to The Journal of Data-centric Machine Learning Research (DMLR).
• 17 Aug, 2024: 💡💡 Wondering how OOD detection evolves and what new research topics could be in the new era ofmultimodal LLMs? Don't hesistate to check out our recent workUnsolvable Problem Detection: Evaluating Trustworthiness of Vision Language Models andGeneralized Out-of-Distribution Detection and Beyond in Vision Language Model Era: A Survey.
• 27 Oct, 2023: A short version of OpenOODv1.5 is accepted toNeurIPS 2023 Workshop on Distribution Shifts as an oral presentation. You may want to check out ourpresentation slides.
• 25 Sept, 2023: OpenOOD now supports OOD detection with foundation models including zero-shot CLIP and DINOv2 linear probe. Check out the example evaluation scripthere.
• 16 June, 2023: 💥💥 We are releasing OpenOODv1.5, which includes the following exciting updates. A detailed changelog is provided in theWiki. An overview of the supported methods and benchmarks (with paper links) is availablehere.
  • A newreport which provides benchmarking results on ImageNet and for full-spectrum detection.
  • A unified, easy-to-use evaluator that allows evaluation by simply creating an evaluator instance and calling its functions. Check out thiscolab tutorial!
  • A liveleaderboard that tracks the state-of-the-art of this field.
• 14 October, 2022: OpenOODv1.0 is accepted to NeurIPS 2022. Check the reporthere.
• 14 June, 2022: We releasev0.5.
• 12 April, 2022: Primary release to supportFull-Spectrum OOD Detection.

We appreciate all contributions to improve OpenOOD. We sincerely welcome community users to participate in these projects.

• For contributing to this repo, please refer toCONTRIBUTING.md for the guideline.
• For adding your method to ourleaderboard, simply open an issue where you will see the template that has detailed instructions.

• APS_mode means Automatic (hyper)Parameter Searching mode, which enables the model to validate all the hyperparameters in the sweep list based on the validation ID/OOD set. The default value is False. Checkhere for example.

OpenOOD now supports installation via pip.

pip install git+https://github.com/Jingkang50/OpenOODpip install libmr# optional, if you want to use CLIP# pip install git+https://github.com/openai/CLIP.git

If you only use our evaluator, the benchmarks for evaluation will be automatically downloaded by the evaluator (again check out thistutorial). If you would like to also use OpenOOD for training, you can get all data with ourdownloading script. Note that ImageNet-1K training images should be downloaded from its official website.

OpenOOD v1.5 focuses on 4 ID datasets, and we release pre-trained models accordingly.

• CIFAR-10[Google Drive]: ResNet-18 classifiers trained with cross-entropy loss from 3 training runs.
• CIFAR-100[Google Drive]: ResNet-18 classifiers trained with cross-entropy loss from 3 training runs.
• ImageNet-200[Google Drive]: ResNet-18 classifiers trained with cross-entropy loss from 3 training runs.
• ImageNet-1K[Google Drive]: ResNet-50 classifiers including 1) the one from torchvision, 2) the ones that are trained by us with specific methods such as MOS, CIDER, and 3) the official checkpoints of data augmentation methods such as AugMix, PixMix.

Again, these checkpoints can be downloaded with the downloading scripthere.

Our codebase accesses the datasets from./data/ and pretrained models from./results/checkpoints/ by default.

├── ...├── data│   ├── benchmark_imglist│   ├── images_classic│   └── images_largescale├── openood├── results│   ├── checkpoints│   └── ...├── scripts├── main.py├── ...

We provide training and evaluation scripts for all the methods we support inscripts folder.

This part lists all the benchmarks we support. Feel free to include more.

Note that OpenOOD v1.5 emphasizes and focuses on the last 4 benchmarks for OOD detection.

This part lists all the backbones we will support in our codebase, including CNN-based and Transformer-based models. Backbones like ResNet-50 and Transformer have ImageNet-1K/22K pretrained models.

This part lists all the methods we include in this codebase. Up tov1.5, we totally supportmore than 50 popular methods for generalized OOD detection.

All the supported methodolgies can be placed in the following four categories.

We also note our supported methodolgies with the following tags if they have special designs in the corresponding steps, compared to the standard classifier training process.

If you find our repository useful for your research, please consider citing these papers:

# v1.5 report@article{zhang2023openood,title={OpenOOD v1.5: Enhanced Benchmark for Out-of-Distribution Detection},author={Zhang, Jingyang and Yang, Jingkang and Wang, Pengyun and Wang, Haoqi and Lin, Yueqian and Zhang, Haoran and Sun, Yiyou and Du, Xuefeng and Li, Yixuan and Liu, Ziwei and Chen, Yiran and Li, Hai},journal={arXiv preprint arXiv:2306.09301},year={2023}}# v1.0 report@article{yang2022openood,author ={Yang, Jingkang and Wang, Pengyun and Zou, Dejian and Zhou, Zitang and Ding, Kunyuan and Peng, Wenxuan and Wang, Haoqi and Chen, Guangyao and Li, Bo and Sun, Yiyou and Du, Xuefeng and Zhou, Kaiyang and Zhang, Wayne and Hendrycks, Dan and Li, Yixuan and Liu, Ziwei},title ={OpenOOD: Benchmarking Generalized Out-of-Distribution Detection},year ={2022}}# full-spectrum OOD detection@article{yang2022fsood,title ={Full-Spectrum Out-of-Distribution Detection},author ={Yang, Jingkang and Zhou, Kaiyang and Liu, Ziwei},journal={arXiv preprint arXiv:2204.05306},year ={2022}}# generalized OOD detection framework & survey@article{yang2021oodsurvey,title={Generalized Out-of-Distribution Detection: A Survey},author={Yang, Jingkang and Zhou, Kaiyang and Li, Yixuan and Liu, Ziwei},journal={arXiv preprint arXiv:2110.11334},year={2021}}# OOD benchmarks# NINCO@inproceedings{bitterwolf2023ninco,title={In or Out? Fixing ImageNet Out-of-Distribution Detection Evaluation},author={Julian Bitterwolf and Maximilian Mueller and Matthias Hein},booktitle={ICML},year={2023},url={https://proceedings.mlr.press/v202/bitterwolf23a.html}}# SSB@inproceedings{vaze2021open,title={Open-Set Recognition: A Good Closed-Set Classifier is All You Need},author={Vaze, Sagar and Han, Kai and Vedaldi, Andrea and Zisserman, Andrew},booktitle={ICLR},year={2022}}