VGG Concept Bottleneck Models

This repository contains code and scripts from the following paper:

Concept Bottleneck Models

Pang Wei Koh*, Thao Nguyen*, Yew Siang Tang*, Stephen Mussmann, Emma Pierson, Been Kim, and Percy Liang

ICML 2020

Changes:

• The model in this repository has been changed to VGG 16
• Indexing for CUB dataset classes and concepts is from 1, not 0
• Added a model converter (details below)
• Updated pip packages

The experiments use the following datasets:

• NIH Osteoarthritis Initiative (OAI)
• Caltech-UCSD Birds 200 (CUB)

To download the TravelingBirds dataset, which we use to test robustness to background shifts, please download the CUB_fixed folder from this CodaLab bundle by clicking on the download button. If you use this dataset, please also cite the original CUB and Places datasets.

The NIH Osteoarthritis Initiative (OAI) dataset requires an application for data access, so we are unable to provide the raw data here. To access that data, please first obtain data access permission from the Osteoarthritis Initiative, and then refer to this Github repository for data processing code. If you use it, please cite the Pierson et al. paper corresponding to that repository as well.

Here, we focus on scripts replicating our results on CUB, which is public. We provide an executable, Dockerized version of those experiments on CodaLab.

Abstract

We seek to learn models that we can interact with using high-level concepts: would the model predict severe arthritis if it thinks there is a bone spur in the x-ray? State-of-the-art models today do not typically support the manipulation of concepts like "the existence of bone spurs", as they are trained end-to-end to go directly from raw input (e.g., pixels) to output (e.g., arthritis severity). We revisit the classic idea of first predicting concepts that are provided at training time, and then using these concepts to predict the label. By construction, we can intervene on these concept bottleneck models by editing their predicted concept values and propagating these changes to the final prediction. On x-ray grading and bird identification, concept bottleneck models achieve competitive accuracy with standard end-to-end models, while enabling interpretation in terms of high-level clinical concepts ("bone spurs") or bird attributes ("wing color"). These models also allow for richer human-model interaction: accuracy improves significantly if we can correct model mistakes on concepts at test time.

Prerequisites

We used the same environment as Codalab's default gpu setting, please run pip install -r requirements.txt. Main packages are:

• matplotlib 3.5.0
• numpy 1.21.4
• pandas 1.3.4
• Pillow 8.4.0
• scipy 1.7.3
• scikit-learn 1.0.1
• torch 1.10.0
• torchvision 0.11.1

Note that we updated Pillow and removed tensorflow-gpu and tensorboard from requirements.txt.
Note Python version is 3.8

Docker

You can pull the Docker image directly from Docker Hub.

docker pull codalab/default-gpu

Usage

Standard task training for CUB can be ran using the scripts/experiments.sh and Codalab scripts can be ran using scripts/codalab_experiments.sh. More information about how to perform data processing and other evaluations can be found in the README in CUB/.

CUB model converter

If a concept bottleneck model is required without the ModuleList concept layer then a script has been provided which will convert this to a more standard linear layer. The model will be saved as a state_dict.

note: At the moment this only supports expand_dim == 0

Example: python CUB_model_converter.py --model_1_path .path/to/XtoC/model.pth --model_2_path .path/to/CtoY/model.pth --model_out_path ./path/to/save/model.pth