Skip to content

Commit a448d02

Browse files
authored
Merge pull request #10 from AdaptiveMotorControlLab/MMathisLab/update-readme
Update README.md
2 parents 5e0634a + d690a86 commit a448d02

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

README.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,25 +5,34 @@
55
This repository contains the code for the paper **"Adversarially Robust Out-of-Distribution Detection Using Lyapunov-Stabilized Embeddings"**. The method, termed **AROS**, employs Neural Ordinary Differential Equations (NODEs) with Lyapunov stability to create robust embeddings for OOD detection, significantly improving performance against adversarial attacks.
66
This repository contains the code for the paper **"Adversarially Robust Out-of-Distribution Detection Using Lyapunov-Stabilized Embeddings"**. The method, termed **AROS**, employs Neural Ordinary Differential Equations (NODEs) with Lyapunov stability to create robust embeddings for OOD detection, significantly improving performance against adversarial attacks. Additionally, the repository includes two notebooks: one demonstrates the training and evaluation process on the CIFAR-10 and CIFAR-100 datasets, while the other focuses on the ablation study.
77

8+
![AROS](https://github.com/user-attachments/assets/b0d9e7f8-e39d-4bae-aee2-79a247b5e87f)
9+
810

911
## Key Features
1012

1113
- **Lyapunov Stability for OOD Detection**: Ensures that perturbed inputs converge back to stable equilibrium points, improving robustness against adversarial attacks.
1214
- **Fake Embedding Crafting Strategy**: Generates fake OOD embeddings by sampling from the low-likelihood regions of the ID data feature space, eliminating the need for additional OOD datasets.
1315
- **Orthogonal Binary Layer**: Enhances separation between ID and OOD embeddings, further improving robustness.
1416

17+
## Demo
18+
19+
- [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/AdaptiveMotorControlLab/AROS/blob/main/Notebooks/AROS.ipynb) This notebook is designed to replicate and analyze the results presented in Table 1 of the AROS paper, focusing on out-of-distribution detection performance under both attack scenarios and clean evaluation.
20+
- [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/AdaptiveMotorControlLab/AROS/blob/main/Notebooks/Ablation_Study.ipynb) This notebook is designed to demo the ablation study.
21+
22+
1523
## Repository Structure
1624

1725

18-
- **AROS/**
26+
- **`AROS/`**
1927
- **`data_loader.py`**: Contains the data loading utilities for training and evaluation.
2028
- **`evaluate.py`**: Implements the evaluation metrics and testing routines for the AROS model.
2129
- **`Main.py`**: The main script for training and testing AROS, combining all components.
2230
- **`stability_loss_function.py`**: Defines the Lyapunov-based loss function used for stabilizing the NODE dynamics.
2331
- **`utils.py`**: Includes various helper functions used throughout the project.
2432
- **`requirements.txt`**: Lists the dependencies required to run the project.
25-
26-
33+
- **`Notebooks/`**
34+
- **`AROS.ipynb`**
35+
- **`Notebooks/Ablation_Study.ipynb`**
2736

2837
## Installation
2938

0 commit comments

Comments
 (0)