Cross-dimensional Weighting for Aggregated Deep Convolutional Features
DESCRIPTIONS
This repository includes a Python implementation of CroW for unsupervised
image retrieval. A full description of this work can be found in the paper.
REFERENCE
Y, Kalantidis, et al. Cross-dimensional weighting for aggregated deep
convolutional features. In Proceedings of the European Conference on
Computer Vision Workshop, pages: 685--701, 2016.
PREREQUIREMENTS
Caffe with Python interface supported
Python2.7 with Numpy, PIL, sklearn supported
LAYOUT
Data
./data/oxford5k/
./data/oxford5k/conv/ # Convolution feature maps
./data/oxford5k/conv/vgg16/all/
./data/oxford5k/conv/vgg16/crop/
./data/oxford5k/conv/vgg19/all/
./data/oxford5k/conv/vgg19/crop/
./data/oxford5k/groundtruth/ # 55*4=220 query groundtruth
./data/oxford5k/image/ # Raw .jpg images
./data/oxford5k/image/all/ # 5063 database images
./data/oxford5k/image/crop/ # 55 crop query images
./data/paris6k/
# Similar to oxford5k, with 6392 database and 55 query images
Documentations
./doc/ # Automatically generated documents
./README # This file
Library
./lib/ # Third-party library files
Source Code
./src/
USAGE
Step 1. Extract crop query images and extract pool5 features.
# Extract cropped query images.
$ ./src/get_query.py --dataset oxford5k
$ ./src/get_query.py --dataset paris6k
# Extract pool5 features.
$ ./src/get_conv.py --dataset oxford5k --model vgg19 --gpu 0
$ ./src/get_conv.py --dataset paris6k --model vgg19 --gpu 0
Step 2. Evaluate.
$ ./src/evaluate.py --test oxford5k --via paris6k --model vgg19
$ ./src/evaluate.py --test paris6k --via oxford5k --model vgg19
AUTHOR
Hao Zhang: zhangh0214@gmail.com
COPYRIGHT
2017 LAMDA
LICENSE
CC BY-SA 3.0
NOTE
20 images out of 6412 Paris6k images are broken. As a common practice,
we manually removed them:
paris_louvre_000136.jpg
paris_louvre_000146.jpg
paris_moulinrouge_000422.jpg
paris_museedorsay_001059.jpg
paris_notredame_000188.jpg
paris_pantheon_000284.jpg
paris_pantheon_000960.jpg
paris_pantheon_000974.jpg
paris_pompidou_000195.jpg
paris_pompidou_000196.jpg
paris_pompidou_000201.jpg
paris_pompidou_000467.jpg
paris_pompidou_000640.jpg
paris_sacrecoeur_000299.jpg
paris_sacrecoeur_000330.jpg
paris_sacrecoeur_000353.jpg
paris_triomphe_000662.jpg
paris_triomphe_000833.jpg
paris_triomphe_000863.jpg
paris_triomphe_000867.jpg