Awesome

PDiscoFormer: Relaxing Part Discovery Constraints with Vision Transformers

Official implementation of the paper "PDiscoFormer: Relaxing Part Discovery Constraints with Vision Transformers", accepted as an Oral presentation at ECCV 2024.

[🤗 Space][Paper] [Supp.] [Arxiv] [🤗 Page] [Video]

Abstract

Computer vision methods that explicitly detect object parts and reason on them are a step towards inherently interpretable models. Existing approaches that perform part discovery driven by a fine-grained classification task make very restrictive assumptions on the geometric properties of the discovered parts; they should be small and compact. Although this prior is useful in some cases, in this paper we show that pre-trained transformer-based vision models, such as self-supervised DINOv2 ViT, enable the relaxation of these constraints. In particular, we find that a total variation (TV) prior, which allows for multiple connected components of any size, substantially outperforms previous work. We test our approach on three fine-grained classification benchmarks: CUB, PartImageNet and Oxford Flowers, and compare our results to previously published methods as well as a re-implementation of the state-of-the-art method PDiscoNet with a transformer-based backbone. We consistently obtain substantial improvements across the board, both on part discovery metrics and the downstream classification task, showing that the strong inductive biases in self-supervised ViT models require to rethink the geometric priors that can be used for unsupervised part discovery.

Model Architecture

Updates

1. The code has been updated to support the NABirds dataset. The corresponding evaluation metrics and pre-trained models have also been added.
2. The models are available via torch hub. The details can be found in the model zoo file.
3. PDiscoformer has been accepted as an Oral presentation at ECCV 2024 :tada:
4. Models are now available via HuggingFace. Thanks to Niels Rogge and Merve Noyan.

Setup

To install the required packages, run the following command: conda env create -f environment.yml

Otherwise, you can also individually install the following packages:

1. PyTorch: Tested upto version 2.3, please raise an issue if you face any problems with more recent versions.
2. Colorcet
3. Matplotlib
4. OpenCV
5. Pandas
6. Scikit-Image
7. Scikit-Learn
8. TorchMetrics
9. timm
10. wandb: It is recommended to create an account and use it for tracking the experiments. Use the '--wandb' flag when running the training script to enable this feature.
11. pycocotools
12. pytopk
13. huggingface-hub

Datasets

CUB

The dataset can be downloaded from here.

The folder structure should look like this:

CUB_200_2011
├── attributes
├── bounding_boxes.txt
├── classes.txt
├── images
├── image_class_labels.txt
├── images.txt
├── parts
├── README
└── train_test_split.txt

PartImageNet OOD

The dataset can be downloaded from here. After downloading the dataset, use the pre-processing script (prepare_partimagenet_ood.py) and train-test split (data_sets/train_test_split_pimagenet_ood.txt) to generate the required annotation files for training and evaluation. The command to run the pre-processing script is as follows:

python prepare_partimagenet_ood.py --anno_path <path to train.json file> --output_dir <path to save the train and test json file> --train_test_split_file data_sets/train_test_split_pimagenet_ood.txt

Oxford Flowers

The dataset is automatically downloaded by the training script with the required folder structure (except for the segmentation masks). If you want to evaluate the foreground segmentation on the dataset, please download the segmentations from here. The final folder structure should look like this:

(root folder)
├── flowers-102 (folder containing the dataset created automatically by the training script)
    ├── segmim (folder containing the segmentation masks)
    ├── jpg
    ├── imagelabels.mat
    └── setid.mat

PartImageNet Seg

The dataset can be downloaded from here. No additional pre-processing is required.

NABirds

The dataset can be downloaded from here. The experiments on this dataset are not present in the paper as they were conducted after the paper was submitted. The folder structure should look like this (essentially the same as CUB except for the attributes):

nabirds
├── bounding_boxes.txt
├── classes.txt
├── images
├── image_class_labels.txt
├── images.txt
├── parts
├── hierarchy.txt
├── README
└── train_test_split.txt

Training

The details of running the training script can be found in the training instructions file.

Evaluation

The details of running the evaluation metrics for both classification and part discovery can be found in the evaluation instructions file.

Model Zoo

The trained models can be found in the model zoo file.

Issues and Questions

Feel free to raise an issue if you face any problems with the code or have any questions about the paper.

Citation

If you find our work useful in your research, please consider citing:

@inproceedings{aniraj2024pdiscoformer,
  title={PDiscoFormer: Relaxing Part Discovery Constraints with Vision Transformers},
  author={Aniraj, Ananthu and Dantas, Cassio F and Ienco, Dino and Marcos, Diego},
  booktitle={Proceedings of the European Conference on Computer Vision (ECCV)},
  month={October},
  year={2024}
}