turinglife / attractionet Goto Github PK

The AttractioNet code implements the following arxiv paper:
Title: "Attend Refine Repeat: Active Box Proposal Generation via In-Out Localization"
Authors: Spyros Gidaris, Nikos Komodakis
Institution: Universite Paris Est, Ecole des Ponts ParisTech
Code: https://github.com/gidariss/AttractioNet
Link: https://arxiv.org/abs/1606.04446

Abstract:
The problem of computing category agnostic bounding box proposals is utilized as a core component in many computer vision tasks and thus has lately attracted a lot of attention. In this work we propose a new approach to tackle this problem that is based on an active strategy for generating box proposals that starts from a set of seed boxes, which are uniformly distributed on the image, and then progressively moves its attention on the promising image areas where it is more likely to discover well localized bounding box proposals. We call our approach AttractioNet and a core component of it is a CNN-based category agnostic object location refinement module that is capable of yielding accurate and robust bounding box predictions regardless of the object category. We extensively evaluate our AttractioNet approach on several image datasets (i.e. COCO, PASCAL, ImageNet detection and NYU-Depth V2 datasets) reporting on all of them state-of-the-art results that surpass the previous work in the field by a significant margin and also providing strong empirical evidence that our approach is capable to generalize to unseen categories. Furthermore, we evaluate our AttractioNet proposals in the context of the object detection task using a VGG16-Net based detector and the achieved detection performance on COCO manages to significantly surpass all other VGG16-Net based detectors while even being competitive with a heavily tuned ResNet-101 based detector.

Average recall results of AttractioNet box proposal generation approach:

Average precision results on COCO test-dev2015 set of a VGG16-Net based object detector with AttractioNet proposals:

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

@article{gidaris2016attend,  
  title={Attend Refine Repeat: Active Box Proposal Generation via In-Out Localization},  
  author={Gidaris, Spyros and Komodakis, Nikos},   
  year={2016}
}  

and

@inproceedings{gidaris2016locnet,  
  title={LocNet: Improving Localization Accuracy for Object Detection},  
  author={Gidaris, Spyros and Komodakis, Nikos},   
  booktitle={Computer Vision and Pattern Recognition (CVPR), 2016 IEEE Conference on},  
  year={2016}  
}

This code is released under the MIT License (refer to the LICENSE file for details).

1. Requirements
2. Installation
3. Downloading pre-computed bounding box proposals
4. Preparing and using the COCO and PASCAL datasets

Hardware. In order to use AttractioNet for extracting bounding box proposals from an image you will require a GPU with at least 4 Gbytes of memory

Software.

1. A modified, in order to support AttractioNet, version of Caffe [link] (you must use the AttractioNet branch).
2. The cuDNN(-v5) library during Caffe installation.
3. Matlab (tested with R2014b).

1. Download and install this modified version of Caffe, initially developed to supprot LocNet and now extended to support AttractioNet (use the AttractioNet branch for the later). Clone Caffe in your local machine:

    
    # $caffe_AttractioNet: directory where Caffe will be cloned 
    git clone https://github.com/gidariss/caffe_LocNet.git $caffe_AttractioNet  
    # switch on the AttractioNet branch  
    git checkout AttractioNet                              

Then follow the Caffe and Matcaffe installation instructions here. Note that you have to install Caffe with the cuDNN(-v5) library.
2. Clone the AttractioNet code in your local machine:

 # $AttractioNet: directory where AttractioNet will be cloned    
 git clone https://github.com/gidariss/AttractioNet $AttractioNet  
 ```   
From now on, the directory where *AttractioNet* is cloned will be called `$AttractioNet`.  
3. Create a symbolic link of [Caffe](https://github.com/gidariss/caffe_LocNet/tree/AttractioNet) installatation directory at `$AttractioNet/external/caffe_AttractioNet`:  
```Shell

 # $AttractioNet: directory where AttractioNet is cloned   
 # $caffe_AttractioNet: directory where caffe is cloned and installed    
 ln -sf $caffe_AttractioNet $AttractioNet/external/caffe_AttractioNet   
 ```      
4.  Open Matlab from the `$AttractioNet/` directory and run the `AttractioNet_build.m` script:  
```Shell

 $ cd $AttractioNet  
 $ matlab   
 
 # matlab command line enviroment
 >> AttractioNet_build   
 ``` 
 Do not worry about the warning messages. They also appear on my machine. 
5. Download the [***AttractioNet pre-trained model***](https://drive.google.com/file/d/0BwxkAdGoNzNTV2N3RjN5dXNpWVE/view?usp=sharing). Note that the provided model is actually the fast version of AttractioNet model that is described on section 3.1.3 of technical report. After downloading, unzip and untar the .tar.gz archive file with the AttractioNet model files on the directory `$AttractioNet/models-exps/AttractioNet_Model` by running:   
```Shell

tar xvfz AttractioNet_Model.tar.gz -C $AttractioNet/models-exps/    

After having complete the installation, you will be able to use AttractioNet for extracting bounding box proposals from any image. For a demo see the demo_AttractioNet.m script. Note that you will require a GPU with at least 4 Gbytes of memory in order to run the demo.

We provide pre-computed bounding box proposals --- using the same AttractioNet model that we provide here --- for the following datasets:

PASCAL VOC:

• Trainval 2007 (135.8 MB)
• Test 2007 (134.2 MB)
• Trainval 2012 (312.6 MB)
• Test 2012 (297.8 Mb)

MS-COCO:

• Train 2014 (2.21 GB)
• Val 2014 (1.08 GB)
• Test 2015 (2.18 GB)

Each package contains the AttractioNet box proposals of the corresponding data set, stored using a separate box proposal file per image. Specifically, the box proposals of each image are stored in Matlab files (.mat files) using the same filenames as those that the images have. Each Matlab file contains a single data field, called boxes, that is a K x 5 single precision array with the box proposals of the corresponding image (where K is the number of box proposals). Each row of the boxes array contains a single bounding box proposal represented by the 5 values [x0,y0,x1,y1,obj], where (x0,y0) and (x1,y1) are its top-left and bottom-right coordinates correspondingly (specifically, 1-based pixel coordinates) and obj is its objectness score. Note that the box proposals are already sorted w.r.t. their objectness score in decreasing order.

In case you need to set up and use the COCO and/or PASCAL datasets (e.g. generating or evaluating AttractioNet proposals) then follow the instructions on the DATASET.md file.